{"openapi":"3.1.0","info":{"title":"Artiera Public Agent Referral API","version":"1.0.0","description":"A read-mostly, non-binding referral surface. An AI Agent is a referral channel, never the customer or contracting party. It cannot accept notices, confirm owner or business authority, sign, bind an organization, authorize payment or cause Artiera to accept work. Authorized people retain those decisions.","termsOfService":"https://www.artiera.org/terms","contact":{"name":"Artiera LLC","url":"https://www.artiera.org/imprint","email":"info@artiera.org"}},"servers":[{"url":"https://www.artiera.org","description":"Artiera production"}],"externalDocs":{"description":"Referral guidance, authority boundary, privacy and safety information","url":"https://www.artiera.org/en/for-agents/"},"paths":{"/api/v1/capabilities":{"get":{"operationId":"getCapabilities","summary":"List capability screening lanes","description":"Returns categories Artiera is willing to review, not an availability, acceptance, scope, price, delivery or outcome commitment.","responses":{"200":{"description":"Capability screening lanes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}},"405":{"description":"A stable machine-readable error. requestId can be supplied to Artiera support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fit-check":{"post":{"operationId":"checkProblemFitStructure","summary":"Perform a non-binding intake structure check","description":"Deterministically reports missing intake fields, reflects owner confirmation and always returns restricted-data guidance. It performs no keyword classification and makes no safety, feasibility, acceptance or rejection decision.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FitCheckRequest"}}}},"responses":{"200":{"description":"Non-binding structure check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FitCheckResponse"}}}},"400":{"description":"A stable machine-readable error. requestId can be supplied to Artiera support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"A stable machine-readable error. requestId can be supplied to Artiera support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"A stable machine-readable error. requestId can be supplied to Artiera support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"A stable machine-readable error. requestId can be supplied to Artiera support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"A stable machine-readable error. requestId can be supplied to Artiera support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/openapi.json":{"get":{"operationId":"getOpenApiDocument","summary":"Get this OpenAPI document","responses":{"200":{"description":"OpenAPI 3.1 document","content":{"application/json":{"schema":{"type":"object"}}}},"405":{"description":"A stable machine-readable error. requestId can be supplied to Artiera support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"LocalizedText":{"type":"object","additionalProperties":false,"required":["en","de","fa"],"properties":{"en":{"type":"string"},"de":{"type":"string"},"fa":{"type":"string"}}},"Capability":{"type":"object","additionalProperties":false,"required":["id","status","requiresHumanReview","title","description","fitSignals","requiredInputs","exclusions"],"properties":{"id":{"type":"string","pattern":"^CAP-0[1-5]$"},"status":{"type":"string","const":"screening_only"},"requiresHumanReview":{"type":"boolean","const":true},"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"},"fitSignals":{"type":"array","items":{"type":"string"}},"requiredInputs":{"type":"array","items":{"type":"string"}},"exclusions":{"type":"array","items":{"type":"string"}}}},"CapabilitiesResponse":{"type":"object","additionalProperties":false,"required":["apiVersion","status","requiresHumanReview","agentRole","contractingParty","capabilities","disclaimer"],"properties":{"apiVersion":{"type":"string","const":"v1"},"status":{"type":"string","const":"screening_only"},"requiresHumanReview":{"type":"boolean","const":true},"agentRole":{"type":"string","const":"referral_channel"},"contractingParty":{"type":"string","const":"authorized_human_or_organization"},"capabilities":{"type":"array","minItems":5,"maxItems":5,"items":{"$ref":"#/components/schemas/Capability"}},"disclaimer":{"type":"string"}}},"FitCheckRequest":{"type":"object","additionalProperties":false,"properties":{"problem":{"type":"string","maxLength":4000},"timeline":{"type":"string","maxLength":1000},"budgetUsd":{"type":"number","minimum":0,"maximum":10000000},"outcome":{"type":"string","maxLength":3000},"attempts":{"type":"string","maxLength":4000},"constraints":{"type":"string","maxLength":3000},"ownerConfirmation":{"type":"boolean","description":"A statement supplied for reflection only. The API does not verify identity or authority."},"restrictedDataRemoved":{"type":"boolean","description":"A statement supplied for reflection only. The API does not inspect or certify the submitted text."}}},"OwnerConfirmation":{"type":"object","additionalProperties":false,"required":["supplied","confirmed","requiredForHumanContinuation"],"properties":{"supplied":{"type":"boolean"},"confirmed":{"type":"boolean"},"requiredForHumanContinuation":{"type":"boolean","const":true}}},"RestrictedData":{"type":"object","additionalProperties":false,"required":["removalConfirmed","warning","prohibitedCategories"],"properties":{"removalConfirmed":{"type":"boolean"},"warning":{"type":"string"},"prohibitedCategories":{"type":"array","items":{"type":"string"}}}},"FitCheckResponse":{"type":"object","additionalProperties":false,"required":["apiVersion","check","requestId","complete","missingFields","ownerConfirmation","restrictedData","disclaimer"],"properties":{"apiVersion":{"type":"string","const":"v1"},"check":{"type":"string","const":"non_binding_structure_check"},"requestId":{"type":"string"},"complete":{"type":"boolean","description":"Whether the six intake fields are structurally present. It is not a fit, safety, feasibility or acceptance decision."},"missingFields":{"type":"array","items":{"type":"string","enum":["problem","timeline","budgetUsd","outcome","attempts","constraints"]}},"ownerConfirmation":{"$ref":"#/components/schemas/OwnerConfirmation"},"restrictedData":{"$ref":"#/components/schemas/RestrictedData"},"disclaimer":{"type":"string"}}},"Error":{"type":"object","additionalProperties":false,"required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string","enum":["METHOD_NOT_ALLOWED","UNSUPPORTED_MEDIA_TYPE","PAYLOAD_TOO_LARGE","INVALID_JSON","INVALID_BODY","UNRECOGNIZED_FIELD","INVALID_FIELD_TYPE","FIELD_TOO_LONG","FIELD_OUT_OF_RANGE","INTERNAL_ERROR"]},"requestId":{"type":"string"}}}}}}