> ## 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. # Get an organization's teardown > Reads the teardown of a team organization the caller deleted: in progress at a stage, or completed. Use this tool when you need to: - Follow a team organization's teardown after deleteOrg answered 202 - Confirm that an organization the caller deleted is gone, with when its teardown completed Examples: - GET /orgs/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/teardown Hints: - orgID is the organization's uuid. state is in_progress, with stage quiesce, settle_billing, destroy_compute, external_teardown or row_deletes, and then completed, with completed_at; started_at is when deleteOrg began it. - It stays readable after the teardown completes, when the organization itself no longer exists. - A teardown that has not moved for a day is stuck on a vendor or a compute drain and is retried in the background; there is nothing to call to resume it. - Use deleteOrg instead to start a teardown. - Only the caller who deleted the organization reads it, from a session-authenticated sign-in: a JWT without a session is refused with 403 session_auth_required, anyone else, and an organization with no teardown, with 404 org_not_found, and credentials other than a session, such as a platform API key, with 401 (an agent host's grant is refused before that with 403 agent_host_route_not_allowed). ## OpenAPI ````yaml api-reference/openapi.json GET /orgs/{orgID}/teardown openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /orgs/{orgID}/teardown: get: tags: - orgs summary: Get an organization's teardown description: >- Reads the teardown of a team organization the caller deleted: in progress at a stage, or completed. Use this tool when you need to: - Follow a team organization's teardown after deleteOrg answered 202 - Confirm that an organization the caller deleted is gone, with when its teardown completed Examples: - GET /orgs/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/teardown Hints: - orgID is the organization's uuid. state is in_progress, with stage quiesce, settle_billing, destroy_compute, external_teardown or row_deletes, and then completed, with completed_at; started_at is when deleteOrg began it. - It stays readable after the teardown completes, when the organization itself no longer exists. - A teardown that has not moved for a day is stuck on a vendor or a compute drain and is retried in the background; there is nothing to call to resume it. - Use deleteOrg instead to start a teardown. - Only the caller who deleted the organization reads it, from a session-authenticated sign-in: a JWT without a session is refused with 403 session_auth_required, anyone else, and an organization with no teardown, with 404 org_not_found, and credentials other than a session, such as a platform API key, with 401 (an agent host's grant is refused before that with 403 agent_host_route_not_allowed). operationId: getOrgTeardown parameters: - in: path name: orgID required: true schema: format: uuid type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/OrgTeardown' description: OK '401': content: application/json: schema: $ref: '#/components/schemas/OrgsErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/OrgsErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/OrgsErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/OrgsErrorResponse' description: Internal Server Error components: schemas: OrgTeardown: discriminator: mapping: completed: '#/components/schemas/OrgTeardownCompleted' in_progress: '#/components/schemas/OrgTeardownInProgress' propertyName: state oneOf: - $ref: '#/components/schemas/OrgTeardownInProgress' - $ref: '#/components/schemas/OrgTeardownCompleted' OrgsErrorResponse: additionalProperties: false properties: code: enum: - already_org_member - bad_gateway - bad_request - conflict - default_actor_product_role_required - empty_org_update - forbidden - gateway_timeout - gone - internal_error - invalid_commit_attribution_policy - invalid_cursor - invalid_invite_email - invalid_invite_status - invalid_org_id - invalid_org_name - invalid_org_role - invalid_pr_authorship - invalid_seat_request_status - invalid_user_id - invite_already_pending - invite_delivery_failed - invite_delivery_unavailable - invite_expired - invite_not_pending - inviter_daily_invite_limit - member_role_changed - method_not_allowed - not_acceptable - not_found - not_implemented - org_default_actor_reassignment_required - org_has_members - org_has_subscription - org_not_found - org_pending_invite_limit - org_role_insufficient - owner_leave_forbidden - owner_removal_forbidden - owner_role_immutable - payment_required - personal_org_delete_forbidden - personal_org_immutable - personal_org_leave_forbidden - precondition_failed - rate_limited - request_canceled - request_timeout - request_too_large - seat_request_delivery_failed - seat_request_pending - service_unavailable - session_auth_required - team_org_required - unauthenticated - unsupported_media_type - validation_failed - viewer_limit_reached 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 OrgTeardownCompleted: additionalProperties: false properties: completed_at: format: date-time type: string org_id: format: uuid type: string started_at: format: date-time type: string state: enum: - completed type: string required: - org_id - state - started_at - completed_at type: object OrgTeardownInProgress: additionalProperties: false properties: org_id: format: uuid type: string stage: enum: - quiesce - settle_billing - destroy_compute - external_teardown - row_deletes type: string started_at: format: date-time type: string state: enum: - in_progress type: string required: - org_id - state - stage - started_at 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.