> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Sentry routes > Lists the organization's Sentry routes, each starting tasks in an Aether project from the new error issues of one Sentry project, ordered by Sentry project name. Use this tool when you need to: - Find a route's route_id before updating or deleting it - See which Sentry projects start tasks, in which Aether project, and whether each route is enabled Examples: - GET /orgs/{orgID}/sentry/routes Hints: - Takes no parameters beyond orgID and is not paged: items holds every route, ordered by sentry_project_name, then route_id. It reads Aether alone; Sentry is not called. - Each route carries route_id, aether_project_id, enabled, agent_profile_id (null for the project's defaults), sentry_project_id, and the sentry_project_slug and sentry_project_name Sentry listed when the route was created. - An enabled route starts one task per new Sentry issue of level error or fatal, in its Aether project, created as the default actor (getSentryStatus) with the route's agent profile. - Use listSentryProjects instead to read the Sentry projects a route can name, and createSentryRoute to add a route. - Owners, admins and members of the organization, with a session or a platform API key; a viewer or billing member is refused with 403 org_role_insufficient, a non-member with 403 org_membership_required, an orgID that is not a uuid with 400, and an agent host's grant with 403 agent_host_route_not_allowed. Refused with 404 not_connected when Sentry is not installed. ## OpenAPI ````yaml api-reference/openapi.json GET /orgs/{orgID}/sentry/routes openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /orgs/{orgID}/sentry/routes: get: tags: - sentry summary: List Sentry routes description: >- Lists the organization's Sentry routes, each starting tasks in an Aether project from the new error issues of one Sentry project, ordered by Sentry project name. Use this tool when you need to: - Find a route's route_id before updating or deleting it - See which Sentry projects start tasks, in which Aether project, and whether each route is enabled Examples: - GET /orgs/{orgID}/sentry/routes Hints: - Takes no parameters beyond orgID and is not paged: items holds every route, ordered by sentry_project_name, then route_id. It reads Aether alone; Sentry is not called. - Each route carries route_id, aether_project_id, enabled, agent_profile_id (null for the project's defaults), sentry_project_id, and the sentry_project_slug and sentry_project_name Sentry listed when the route was created. - An enabled route starts one task per new Sentry issue of level error or fatal, in its Aether project, created as the default actor (getSentryStatus) with the route's agent profile. - Use listSentryProjects instead to read the Sentry projects a route can name, and createSentryRoute to add a route. - Owners, admins and members of the organization, with a session or a platform API key; a viewer or billing member is refused with 403 org_role_insufficient, a non-member with 403 org_membership_required, an orgID that is not a uuid with 400, and an agent host's grant with 403 agent_host_route_not_allowed. Refused with 404 not_connected when Sentry is not installed. operationId: listSentryRoutes parameters: - in: path name: orgID required: true schema: format: uuid type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListSentryRoute' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/SentryErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/SentryErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/SentryErrorResponse' description: Not Found '500': content: application/json: schema: $ref: '#/components/schemas/SentryErrorResponse' description: Internal Server Error components: schemas: ListSentryRoute: additionalProperties: false properties: items: items: $ref: '#/components/schemas/SentryRoute' type: array required: - items type: object SentryErrorResponse: additionalProperties: false properties: code: enum: - agent_profile_not_found - bad_gateway - bad_request - conflict - default_actor_not_member - forbidden - gateway_timeout - gone - internal_error - method_not_allowed - not_acceptable - not_connected - not_found - not_implemented - payment_required - precondition_failed - project_not_found - project_repo_required - rate_limited - reauthorization_required - request_canceled - request_timeout - request_too_large - route_exists - route_not_found - sentry_project_not_found - service_unavailable - unauthenticated - unsupported_media_type - validation_failed minLength: 1 type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error - code type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting - agent_host_route_not_allowed - credential_kind_not_admitted type: string error: minLength: 1 type: string required: - error - code type: object SentryRoute: additionalProperties: false properties: aether_project_id: format: uuid type: string agent_profile_id: description: >- The agent profile tasks the route starts run with; null for the project's defaults. format: uuid type: - string - 'null' enabled: type: boolean route_id: format: uuid type: string sentry_project_id: minLength: 1 type: string sentry_project_name: minLength: 1 type: string sentry_project_slug: minLength: 1 type: string required: - route_id - aether_project_id - enabled - agent_profile_id - sentry_project_id - sentry_project_slug - sentry_project_name type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.