# Tiles

## List all dashboard tiles

> Returns an array of tile objects, one per integration plus a\
> standalone-flows tile whose \`\_integrationId\` is the literal string\
> \`"none"\`.\
> \
> Use the query parameters below to filter the results.

```json
{"openapi":"3.1.0","info":{"title":"Tiles","version":"1.0.0"},"servers":[{"url":"https://api.integrator.io","description":"Production (US / default region)"},{"url":"https://api.eu.integrator.io","description":"Production (EU region)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Tile":{"type":"object","description":"Dashboard tile summarizing an integration or the standalone-flows bucket.\nThe list endpoint returns the full shape; the get-by-id endpoint omits\n`name` and `_parentId`.\n","properties":{"_integrationId":{"type":"string","description":"The integration id this tile represents, or the literal string\n`\"none\"` for the standalone-flows tile.\n"},"name":{"type":"string","description":"Display name of the integration. Present in the list response only."},"numFlows":{"type":"integer","description":"Total number of flows in this integration."},"numApis":{"type":"integer","description":"Total number of API endpoints in this integration."},"numError":{"type":"integer","description":"Number of flows currently in an error state."},"offlineConnections":{"type":"array","description":"Connection ids that are currently offline.","items":{"type":"string"}},"_parentId":{"type":"string","description":"Parent integration id for child integrations. Present in list response only."},"lastErrorAt":{"type":"string","format":"date-time","description":"Timestamp of the most recent error across all flows."},"lastModified":{"type":"string","format":"date-time","description":"Timestamp of the most recent modification."},"mode":{"type":"string","description":"Integration mode, if applicable."},"supportsChild":{"type":"boolean","description":"Whether this integration supports child integrations."},"iaV2":{"type":"boolean","description":"Whether this integration uses Integration App v2 architecture."},"_registeredConnectionIds":{"type":"array","description":"Connections registered to this integration via a connector.","items":{"type":"string"}},"description":{"type":"string","description":"Description of the integration."},"_templateId":{"type":"string","description":"Template id if the integration was installed from a template."}},"required":["_integrationId","numFlows","numApis","numError","offlineConnections"]}},"responses":{"401-unauthorized":{"description":"Unauthorized. The request lacks a valid bearer token, or the provided token\nfailed to authenticate.\n\nNote: the 401 response is produced by the auth middleware **before** the\nrequest reaches the endpoint handler, so it does **not** follow the\nstandard `{errors: [...]}` envelope. Instead the body is a bare\n`{message: string}` object with no `code`, no `errors` array. Callers\nhandling 401s should key off the HTTP status and the `message` string,\nnot try to destructure an `errors[]`.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable description of the auth failure. Known values:\n- `\"Unauthorized\"` — no `Authorization` header on the request.\n- `\"Bearer Authentication Failed\"` — header present but token\n  is invalid, revoked, or expired."}},"required":["message"]}}}}}},"paths":{"/v1/tiles":{"get":{"operationId":"listTiles","tags":["Tiles"],"summary":"List all dashboard tiles","description":"Returns an array of tile objects, one per integration plus a\nstandalone-flows tile whose `_integrationId` is the literal string\n`\"none\"`.\n\nUse the query parameters below to filter the results.","responses":{"200":{"description":"Successfully retrieved list of tiles.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tile"}}}}},"401":{"$ref":"#/components/responses/401-unauthorized"}}}}}}
```

## Get a dashboard tile

> Returns the tile for a specific integration. Use the literal string\
> \`none\` as the \`\_integrationId\` to retrieve the standalone-flows tile.\
> \
> The response shape is narrower than the list endpoint — fields such as\
> \`name\` and \`\_parentId\` are not included.

```json
{"openapi":"3.1.0","info":{"title":"Tiles","version":"1.0.0"},"servers":[{"url":"https://api.integrator.io","description":"Production (US / default region)"},{"url":"https://api.eu.integrator.io","description":"Production (EU region)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Tile":{"type":"object","description":"Dashboard tile summarizing an integration or the standalone-flows bucket.\nThe list endpoint returns the full shape; the get-by-id endpoint omits\n`name` and `_parentId`.\n","properties":{"_integrationId":{"type":"string","description":"The integration id this tile represents, or the literal string\n`\"none\"` for the standalone-flows tile.\n"},"name":{"type":"string","description":"Display name of the integration. Present in the list response only."},"numFlows":{"type":"integer","description":"Total number of flows in this integration."},"numApis":{"type":"integer","description":"Total number of API endpoints in this integration."},"numError":{"type":"integer","description":"Number of flows currently in an error state."},"offlineConnections":{"type":"array","description":"Connection ids that are currently offline.","items":{"type":"string"}},"_parentId":{"type":"string","description":"Parent integration id for child integrations. Present in list response only."},"lastErrorAt":{"type":"string","format":"date-time","description":"Timestamp of the most recent error across all flows."},"lastModified":{"type":"string","format":"date-time","description":"Timestamp of the most recent modification."},"mode":{"type":"string","description":"Integration mode, if applicable."},"supportsChild":{"type":"boolean","description":"Whether this integration supports child integrations."},"iaV2":{"type":"boolean","description":"Whether this integration uses Integration App v2 architecture."},"_registeredConnectionIds":{"type":"array","description":"Connections registered to this integration via a connector.","items":{"type":"string"}},"description":{"type":"string","description":"Description of the integration."},"_templateId":{"type":"string","description":"Template id if the integration was installed from a template."}},"required":["_integrationId","numFlows","numApis","numError","offlineConnections"]},"Error":{"type":"object","description":"Standard error response envelope returned by integrator.io APIs.","properties":{"errors":{"type":"array","description":"List of errors that occurred while processing the request.","items":{"type":"object","properties":{"code":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Machine-readable error code. Usually a string like\n`invalid_ref`, `missing_required_field`, or `unauthorized`;\nmay be an **integer** when the error mirrors an upstream HTTP\nstatus (e.g. `500`) — most commonly returned by connection-ping\nand adaptor-proxy responses."},"message":{"type":"string","description":"Human-readable description of the error."},"field":{"type":"string","description":"Optional pointer to the document field that caused the error.\nUsed by structural validation errors (`missing_required_field`,\n`invalid_ref`) to indicate which field is at fault\n(e.g. `_id`, `type`, `http.baseURI`)."},"source":{"type":"string","description":"Optional origin layer for the error — e.g. `application` when\nthe error came from the remote system the adaptor called,\n`connector` when the adaptor itself rejected the request."}},"required":["message"]}}},"required":["errors"]}},"responses":{"401-unauthorized":{"description":"Unauthorized. The request lacks a valid bearer token, or the provided token\nfailed to authenticate.\n\nNote: the 401 response is produced by the auth middleware **before** the\nrequest reaches the endpoint handler, so it does **not** follow the\nstandard `{errors: [...]}` envelope. Instead the body is a bare\n`{message: string}` object with no `code`, no `errors` array. Callers\nhandling 401s should key off the HTTP status and the `message` string,\nnot try to destructure an `errors[]`.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable description of the auth failure. Known values:\n- `\"Unauthorized\"` — no `Authorization` header on the request.\n- `\"Bearer Authentication Failed\"` — header present but token\n  is invalid, revoked, or expired."}},"required":["message"]}}}},"404-not-found":{"description":"Not found. The requested resource does not exist or is not visible to the caller.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/tiles/{_integrationId}":{"get":{"operationId":"getTileById","tags":["Tiles"],"summary":"Get a dashboard tile","description":"Returns the tile for a specific integration. Use the literal string\n`none` as the `_integrationId` to retrieve the standalone-flows tile.\n\nThe response shape is narrower than the list endpoint — fields such as\n`name` and `_parentId` are not included.","parameters":[{"name":"_integrationId","in":"path","description":"The integration id, or the literal string `none` for the\nstandalone-flows tile.\n","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Tile retrieved successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tile"}}}},"401":{"$ref":"#/components/responses/401-unauthorized"},"404":{"$ref":"#/components/responses/404-not-found"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.celigo.com/api/api-reference/tiles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.