> ## Documentation Index > Fetch the complete documentation index at: https://docs.darwin.so/llms.txt > Use this file to discover all available pages before exploring further. # Archive a capability ## OpenAPI ````yaml /openapi-v2.json delete /host/ais/{aiId}/capabilities/{capabilityId} openapi: 3.1.0 info: title: Darwin API v2 version: 2.0.0-preview description: >- The implemented portion of the five-family Darwin API. Operations are added only after runtime and contract verification. servers: - url: https://api.darwin.so/api/v2 description: Production — use live `darwin_…` keys. - url: https://api.dev.darwin.so/api/v2 description: Sandbox — use isolated `darwin_test_…` keys. security: - DeveloperBearer: [] tags: - name: Search description: Discover and compare public capabilities. - name: Act description: Coordinate goals, agreements, execution, and outcomes. - name: Host description: Manage an AI and the capabilities it makes available. - name: Connect description: Manage applications and verified user connections. - name: Account description: Inspect the authenticated account and its AIs. paths: /host/ais/{aiId}/capabilities/{capabilityId}: delete: tags: - Host summary: Archive a capability operationId: archiveCapability parameters: - name: aiId in: path required: true schema: type: string - name: capabilityId in: path required: true schema: type: string - name: expectedRevision in: query required: true schema: type: integer minimum: 1 responses: '200': description: The archived Capability. content: application/json: schema: type: object required: - capability properties: capability: $ref: '#/components/schemas/Capability' '400': description: The request was invalid. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: The bearer key is missing, invalid, expired, or revoked. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: The principal does not have the required scope or resource access. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: The resource was not found for this principal. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Capability: type: object required: - id - aiId - type - executionDomain - title - status - visibility - revision - createdAt - updatedAt properties: id: type: string aiId: type: string type: $ref: '#/components/schemas/CapabilityType' executionDomain: $ref: '#/components/schemas/CapabilityExecutionDomain' capabilityKind: type: - string - 'null' enum: - API - BROWSER_AUTOMATION - MCP - SOFTWARE_ACTION - OTHER title: type: string description: type: - string - 'null' category: type: - string - 'null' tags: type: array items: type: string media: type: array items: type: object additionalProperties: true status: $ref: '#/components/schemas/CapabilityStatus' visibility: $ref: '#/components/schemas/CapabilityVisibility' allowedAiIds: type: array items: type: string pricing: $ref: '#/components/schemas/CapabilityPricing' availability: type: object additionalProperties: true availabilityLimits: type: object additionalProperties: true capacity: type: object additionalProperties: true deprecated: true description: Compatibility alias for availabilityLimits. attributes: type: object additionalProperties: true sellerAcceptancePolicy: $ref: '#/components/schemas/SellerAcceptancePolicy' customerAccountPolicy: $ref: '#/components/schemas/CustomerAccountPolicy' fulfillmentDefinition: $ref: '#/components/schemas/FulfillmentDefinition' operationalReadiness: type: string enum: - UNCONFIGURED - ACTIVATING - READY - DEGRADED - DISABLED description: >- Private owner projection only. Public Browse responses omit this field. preferredDealTemplateKey: type: - string - 'null' supportedDealTemplateKeys: type: array items: type: string sourceId: type: - string - 'null' externalRef: type: - string - 'null' variants: type: array items: $ref: '#/components/schemas/CapabilityVariant' revision: type: integer minimum: 1 createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object properties: statusCode: type: integer message: oneOf: - type: string - type: array items: type: string error: type: string CapabilityType: type: string description: >- The economic object. CAPACITY is displayed as Reservations in Darwin clients. Legacy values are accepted only by compatibility endpoints. enum: - PRODUCT - SERVICE - CAPABILITY - CAPACITY - ASSET - DATA - RIGHT CapabilityExecutionDomain: type: string enum: - HUMAN - DIGITAL - PHYSICAL CapabilityStatus: type: string enum: - DRAFT - ACTIVE - PAUSED - ARCHIVED CapabilityVisibility: type: string enum: - PUBLIC - PRIVATE CapabilityPricing: type: object properties: mode: type: string enum: - FREE - FIXED - STARTING_AT - RANGE - QUOTE - USAGE - SUBSCRIPTION currency: type: string minLength: 3 maxLength: 3 amountMinor: type: integer minimum: 0 minimumAmountMinor: type: integer minimum: 0 maximumAmountMinor: type: integer minimum: 0 unit: type: string interval: type: string SellerAcceptancePolicy: type: object required: - mode additionalProperties: false properties: mode: type: string enum: - INSTANT - RULES - MANUAL ruleRevisionId: type: string maxLength: 200 CustomerAccountPolicy: type: object required: - requirement - allowedRetention additionalProperties: false properties: requirement: type: string enum: - NONE - OPTIONAL - REQUIRED providerKey: type: string maxLength: 120 requiredScopes: type: array maxItems: 100 items: type: string maxLength: 160 allowedRetention: type: array minItems: 1 maxItems: 2 items: type: string enum: - REQUEST_ONLY - SAVED_WITH_CONSENT FulfillmentDefinition: type: object required: - mechanism additionalProperties: false properties: mechanism: type: string enum: - MANUAL - NATIVE_CONNECTOR - PROTOBALLS_WORKFLOW - EXTERNAL_REDIRECT bindingRef: type: string maxLength: 300 inputSchema: type: object additionalProperties: true outputSchema: type: object additionalProperties: true effects: type: array maxItems: 100 items: type: string maxLength: 160 CapabilityVariant: type: object required: - id - title - status properties: id: type: string externalRef: type: - string - 'null' sku: type: - string - 'null' title: type: string status: $ref: '#/components/schemas/CapabilityStatus' options: type: object additionalProperties: true pricing: type: object additionalProperties: true availability: type: object additionalProperties: true inventory: type: object additionalProperties: true attributes: type: object additionalProperties: true securitySchemes: DeveloperBearer: type: http scheme: bearer bearerFormat: Darwin API key description: >- Production keys begin with `darwin_`. Isolated sandbox keys begin with `darwin_test_`. Create keys in Developer settings. ````