{"openapi":"3.1.0","info":{"title":"Artefaktum","description":"Discovery and trust for artifacts exchanged between AI agents.","version":"0.1.0"},"paths":{"/health/live":{"get":{"tags":["system"],"summary":"Live","operationId":"live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Live Health Live Get"}}}}}}},"/health/ready":{"get":{"tags":["system"],"summary":"Ready","operationId":"ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/whoami":{"get":{"tags":["system"],"summary":"Whoami","operationId":"whoami_health_whoami_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":"Response Whoami Health Whoami Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/projects":{"get":{"tags":["projects"],"summary":"List Projects","operationId":"list_projects_v1_projects_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/files":{"post":{"tags":["artifacts"],"summary":"Upload a file in one request","description":"The body is the file, and its Content-Type is stored as the artifact's; or a\nmultipart/form-data body with one file part named `file`, whose text fields may carry\nthe same details as the query (a field wins over a parameter). Up to the\nsingle-request upload limit; larger files use the three-step upload. `201` when bytes\nwere stored, `200` on a `reuse` hit.","operationId":"upload_file_v1_artifacts_files_post","responses":{"201":{"description":"Bytes were stored: a new artifact or a new version.","content":{"application/json":{"schema":{}}}},"200":{"description":"A `reuse` hit: the existing artifact, nothing stored.","content":{"application/json":{"schema":{}}}},"409":{"description":"The key already exists (`if_exists=error`), or under `reuse` another upload of the key was still in progress after the wait (`upload_pending`).","content":{"application/problem+json":{"schema":{"type":"object"}}}},"413":{"description":"The file is over the single-request upload limit; use the three-step upload.","content":{"application/problem+json":{"schema":{"type":"object"}}}},"502":{"description":"Object storage did not accept the file; nothing was stored.","content":{"application/problem+json":{"schema":{"type":"object"}}}},"503":{"description":"Too many uploads are in progress on this server, or for this account.","content":{"application/problem+json":{"schema":{"type":"object"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds."}}}},"parameters":[{"name":"title","in":"query","required":false,"schema":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"description":"Required: as a query parameter for a raw upload, as a query parameter or a form field for a form upload."},{"name":"project","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Project slug or id; default `default`.","title":"Project"}},{"name":"key","in":"query","required":false,"schema":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"title":"Key"}},{"name":"if_exists","in":"query","required":false,"schema":{"default":"error","enum":["error","version","reuse"],"title":"If Exists","type":"string"}},{"name":"max_age_seconds","in":"query","required":false,"schema":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"title":"Max Age Seconds"}},{"name":"filename","in":"query","required":false,"schema":{"anyOf":[{"maxLength":1024,"minLength":1,"type":"string"},{"type":"null"}],"title":"Filename"}},{"name":"description","in":"query","required":false,"schema":{"default":"","maxLength":10000,"title":"Description","type":"string"}},{"name":"tag","in":"query","required":false,"schema":{"description":"Repeat for more than one tag.","items":{"maxLength":64,"minLength":1,"type":"string"},"maxItems":50,"title":"Tag","type":"array"}},{"name":"expires_in_hours","in":"query","required":false,"schema":{"anyOf":[{"exclusiveMinimum":0,"maximum":87600,"type":"integer"},{"type":"null"}],"title":"Expires In Hours"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"title":"Run Id"}}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}},"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"project":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Project slug or id; default `default`.","title":"Project"},"key":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"title":"Key"},"if_exists":{"default":"error","enum":["error","version","reuse"],"title":"If Exists","type":"string"},"max_age_seconds":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"title":"Max Age Seconds"},"filename":{"anyOf":[{"maxLength":1024,"minLength":1,"type":"string"},{"type":"null"}],"title":"Filename"},"description":{"default":"","maxLength":10000,"title":"Description","type":"string"},"tag":{"description":"Repeat for more than one tag.","items":{"maxLength":64,"minLength":1,"type":"string"},"maxItems":50,"title":"Tag","type":"array"},"expires_in_hours":{"anyOf":[{"exclusiveMinimum":0,"maximum":87600,"type":"integer"},{"type":"null"}],"title":"Expires In Hours"},"run_id":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"title":"Run Id"}},"required":["file"]}}}}}},"/v1/artifacts/uploads":{"post":{"tags":["artifacts"],"summary":"Create Upload","operationId":"create_upload_v1_artifacts_uploads_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUploadRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}/versions/{version_id}/complete":{"post":{"tags":["artifacts"],"summary":"Complete Upload","operationId":"complete_upload_v1_artifacts__artifact_id__versions__version_id__complete_post","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Version Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CompleteUploadRequest"},{"type":"null"}],"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactRef"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts":{"get":{"tags":["artifacts"],"summary":"List Artifacts","operationId":"list_artifacts_v1_artifacts_get","parameters":[{"name":"project_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Status"}},{"name":"content_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"}},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag"}},{"name":"external_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Key"}},{"name":"created_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created Before"}},{"name":"created_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created After"}},{"name":"expires_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires Before"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/by-external-key/{external_key}":{"get":{"tags":["artifacts"],"summary":"By External Key","operationId":"by_external_key_v1_artifacts_by_external_key__external_key__get","parameters":[{"name":"external_key","in":"path","required":true,"schema":{"type":"string","title":"External Key"}},{"name":"project_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"}},{"name":"max_age_seconds","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}],"title":"Max Age Seconds"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}":{"get":{"tags":["artifacts"],"summary":"Get Artifact","operationId":"get_artifact_v1_artifacts__artifact_id__get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["artifacts"],"summary":"Update Metadata","operationId":"update_metadata_v1_artifacts__artifact_id__patch","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMetadataRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["artifacts"],"summary":"Delete Artifact","operationId":"delete_artifact_v1_artifacts__artifact_id__delete","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}/versions":{"get":{"tags":["artifacts"],"summary":"List Versions","operationId":"list_versions_v1_artifacts__artifact_id__versions_get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VersionView"},"title":"Response List Versions V1 Artifacts  Artifact Id  Versions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}/download":{"get":{"tags":["artifacts"],"summary":"Download","operationId":"download_v1_artifacts__artifact_id__download_get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"version_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Version Id"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}/uploads":{"post":{"tags":["artifacts"],"summary":"Create Version","operationId":"create_version_v1_artifacts__artifact_id__uploads_post","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVersionRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}/relations":{"post":{"tags":["artifacts"],"summary":"Add Relation","operationId":"add_relation_v1_artifacts__artifact_id__relations_post","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRelationRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["artifacts"],"summary":"List Relations","operationId":"list_relations_v1_artifacts__artifact_id__relations_get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RelationView"},"title":"Response List Relations V1 Artifacts  Artifact Id  Relations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/search":{"post":{"tags":["artifacts"],"summary":"Search Artifacts","operationId":"search_artifacts_v1_artifacts_search_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/resolve":{"post":{"tags":["artifacts"],"summary":"Resolve Artifact","operationId":"resolve_artifact_v1_artifacts_resolve_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs":{"post":{"tags":["runs"],"summary":"Register Run","operationId":"register_run_v1_runs_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRunRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs/{run_id}/seal":{"post":{"tags":["runs"],"summary":"Seal Run","operationId":"seal_run_v1_runs__run_id__seal_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs/{run_id}/artifacts":{"get":{"tags":["runs"],"summary":"List Run Artifacts","operationId":"list_run_artifacts_v1_runs__run_id__artifacts_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage":{"get":{"tags":["usage"],"summary":"Get Usage","operationId":"get_usage_v1_usage_get","parameters":[{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End"}},{"name":"granularity","in":"query","required":false,"schema":{"type":"string","default":"hour","title":"Granularity"}},{"name":"metric","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric"}},{"name":"project_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"}},{"name":"principal_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Principal Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageSeries"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quota":{"get":{"tags":["quota"],"summary":"Get Quota","operationId":"get_quota_v1_quota_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys":{"post":{"tags":["api-keys"],"summary":"Create Key","operationId":"create_key_v1_api_keys_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedKey"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["api-keys"],"summary":"List Keys","operationId":"list_keys_v1_api_keys_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KeyView"},"title":"Response List Keys V1 Api Keys Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}":{"delete":{"tags":["api-keys"],"summary":"Revoke Key","operationId":"revoke_key_v1_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/paddle":{"post":{"tags":["webhooks"],"summary":"Paddle Webhook","operationId":"paddle_webhook_v1_webhooks_paddle_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Paddle Webhook V1 Webhooks Paddle Post"}}}}}}},"/v1/webhooks/clerk":{"post":{"tags":["webhooks"],"summary":"Clerk Webhook","operationId":"clerk_webhook_v1_webhooks_clerk_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Clerk Webhook V1 Webhooks Clerk Post"}}}}}}},"/v1/billing/portal":{"post":{"tags":["billing"],"summary":"Portal","description":"Mint a portal link for the caller's tenant. Links are single-use; never cache.","operationId":"portal_v1_billing_portal_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalLinksView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/signup-source":{"post":{"tags":["me"],"summary":"Set Signup Source","operationId":"set_signup_source_v1_me_signup_source_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupSourceRequest"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ArtifactList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ArtifactView"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"ArtifactList"},"ArtifactRef":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"version_id":{"type":"string","format":"uuid","title":"Version Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","version_id","status"],"title":"ArtifactRef"},"ArtifactView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"project_id":{"type":"string","format":"uuid","title":"Project Id"},"external_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Key"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"status":{"type":"string","title":"Status"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_by":{"type":"string","title":"Created By"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"latest_version":{"anyOf":[{"$ref":"#/components/schemas/VersionView"},{"type":"null"}]},"semantic_ready":{"type":"boolean","title":"Semantic Ready","default":false},"superseded":{"type":"boolean","title":"Superseded","default":false},"superseded_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Superseded By"},"stale_upstream":{"type":"boolean","title":"Stale Upstream","default":false}},"type":"object","required":["id","project_id","external_key","title","description","tags","metadata","status","expires_at","created_by","created_at","updated_at","latest_version"],"title":"ArtifactView"},"CallQuota":{"properties":{"used":{"type":"integer","title":"Used"},"limit":{"type":"integer","title":"Limit"},"resets_at":{"type":"string","format":"date-time","title":"Resets At"}},"type":"object","required":["used","limit","resets_at"],"title":"CallQuota"},"CompleteUploadRequest":{"properties":{"etag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Etag"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"}},"additionalProperties":false,"type":"object","title":"CompleteUploadRequest"},"CreateKeyRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"scopes":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Scopes"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"additionalProperties":false,"type":"object","required":["name","scopes"],"title":"CreateKeyRequest"},"CreateRelationRequest":{"properties":{"to_artifact_id":{"type":"string","format":"uuid","title":"To Artifact Id"},"to_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"To Version Id"},"relation_type":{"type":"string","maxLength":64,"minLength":1,"title":"Relation Type"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"At most 16384 bytes as compact JSON, nested at most 5 levels deep."}},"additionalProperties":false,"type":"object","required":["to_artifact_id","relation_type"],"title":"CreateRelationRequest"},"CreateRunRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id"},"run_id":{"anyOf":[{"type":"string","maxLength":128,"minLength":1},{"type":"null"}],"title":"Run Id"}},"additionalProperties":false,"type":"object","required":["project_id"],"title":"CreateRunRequest"},"CreateUploadRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id"},"filename":{"type":"string","maxLength":1024,"minLength":1,"title":"Filename"},"content_type":{"type":"string","maxLength":255,"minLength":1,"title":"Content Type"},"size_bytes":{"type":"integer","exclusiveMinimum":0.0,"title":"Size Bytes"},"title":{"type":"string","maxLength":500,"minLength":1,"title":"Title"},"description":{"type":"string","maxLength":10000,"title":"Description","default":""},"tags":{"items":{"type":"string","maxLength":64,"minLength":1},"type":"array","maxItems":50,"title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"At most 16384 bytes as compact JSON, nested at most 5 levels deep."},"external_key":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"External Key"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"run_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Run Id"},"infer_lineage":{"type":"boolean","title":"Infer Lineage","default":true}},"additionalProperties":false,"type":"object","required":["project_id","filename","content_type","size_bytes","title"],"title":"CreateUploadRequest"},"CreateUploadResponse":{"properties":{"artifact":{"$ref":"#/components/schemas/ArtifactRef"},"upload":{"$ref":"#/components/schemas/UploadInstructions"}},"type":"object","required":["artifact","upload"],"title":"CreateUploadResponse"},"CreateVersionRequest":{"properties":{"filename":{"type":"string","maxLength":1024,"minLength":1,"title":"Filename"},"content_type":{"type":"string","maxLength":255,"minLength":1,"title":"Content Type"},"size_bytes":{"type":"integer","exclusiveMinimum":0.0,"title":"Size Bytes"},"run_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Run Id"},"infer_lineage":{"type":"boolean","title":"Infer Lineage","default":true}},"additionalProperties":false,"type":"object","required":["filename","content_type","size_bytes"],"title":"CreateVersionRequest"},"CreatedKey":{"properties":{"key":{"$ref":"#/components/schemas/KeyView"},"secret":{"type":"string","title":"Secret"}},"type":"object","required":["key","secret"],"title":"CreatedKey"},"DownloadView":{"properties":{"url":{"type":"string","title":"Url"},"method":{"type":"string","title":"Method"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"version_id":{"type":"string","format":"uuid","title":"Version Id"}},"type":"object","required":["url","method","expires_at","version_id"],"title":"DownloadView"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KeyView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","project_id","scopes","last_used_at","expires_at","revoked_at","created_at"],"title":"KeyView"},"PortalLinksView":{"properties":{"overview_url":{"type":"string","title":"Overview Url"},"cancel_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancel Url"},"update_payment_method_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Update Payment Method Url"}},"type":"object","required":["overview_url","cancel_url","update_payment_method_url"],"title":"PortalLinksView"},"ProjectList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProjectView"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"ProjectList"},"ProjectView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","slug","created_at"],"title":"ProjectView"},"QuotaView":{"properties":{"plan":{"type":"string","title":"Plan"},"storage":{"$ref":"#/components/schemas/StorageQuota"},"calls":{"$ref":"#/components/schemas/CallQuota"},"max_file_bytes":{"type":"integer","title":"Max File Bytes"}},"type":"object","required":["plan","storage","calls","max_file_bytes"],"title":"QuotaView"},"RelationView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"direction":{"type":"string","title":"Direction"},"relation_type":{"type":"string","title":"Relation Type"},"origin":{"type":"string","title":"Origin"},"from_artifact_id":{"type":"string","format":"uuid","title":"From Artifact Id"},"from_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"From Version Id"},"to_artifact_id":{"type":"string","format":"uuid","title":"To Artifact Id"},"to_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"To Version Id"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","direction","relation_type","origin","from_artifact_id","from_version_id","to_artifact_id","to_version_id","run_id","metadata","created_at"],"title":"RelationView"},"ResolveRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id"},"external_key":{"type":"string","maxLength":512,"minLength":1,"title":"External Key"},"max_age_seconds":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Age Seconds"},"filename":{"type":"string","maxLength":1024,"minLength":1,"title":"Filename"},"content_type":{"type":"string","maxLength":255,"minLength":1,"title":"Content Type"},"size_bytes":{"type":"integer","exclusiveMinimum":0.0,"title":"Size Bytes"},"title":{"type":"string","maxLength":500,"minLength":1,"title":"Title"},"description":{"type":"string","maxLength":10000,"title":"Description","default":""},"tags":{"items":{"type":"string","maxLength":64,"minLength":1},"type":"array","maxItems":50,"title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"At most 16384 bytes as compact JSON, nested at most 5 levels deep."},"run_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Run Id"}},"additionalProperties":false,"type":"object","required":["project_id","external_key","filename","content_type","size_bytes","title"],"title":"ResolveRequest"},"ResolveResponse":{"properties":{"status":{"type":"string","enum":["hit","create","pending"],"title":"Status"},"artifact":{"anyOf":[{"$ref":"#/components/schemas/ArtifactView"},{"type":"null"}]},"reservation":{"anyOf":[{"$ref":"#/components/schemas/ArtifactRef"},{"type":"null"}]},"upload":{"anyOf":[{"$ref":"#/components/schemas/UploadInstructions"},{"type":"null"}]},"retry_after_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retry After Seconds"}},"type":"object","required":["status"],"title":"ResolveResponse"},"RunView":{"properties":{"id":{"type":"string","title":"Id"},"project_id":{"type":"string","format":"uuid","title":"Project Id"},"created_by":{"type":"string","title":"Created By"},"sealed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sealed At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","project_id","created_by","sealed_at","created_at"],"title":"RunView"},"SearchFilters":{"properties":{"content_types":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Content Types"},"tags_all":{"items":{"type":"string","maxLength":64,"minLength":1},"type":"array","maxItems":50,"title":"Tags All"},"status":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Status"},"external_key":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"External Key"},"created_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created After"},"created_before":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created Before"},"exclude_superseded":{"type":"boolean","title":"Exclude Superseded","default":true}},"additionalProperties":false,"type":"object","title":"SearchFilters"},"SearchHit":{"properties":{"artifact":{"$ref":"#/components/schemas/ArtifactView"},"score":{"type":"number","title":"Score"},"match_mode":{"type":"string","title":"Match Mode"}},"type":"object","required":["artifact","score","match_mode"],"title":"SearchHit"},"SearchRequest":{"properties":{"project_id":{"type":"string","format":"uuid","title":"Project Id"},"query":{"type":"string","maxLength":1000,"title":"Query","default":""},"mode":{"type":"string","enum":["exact","text","semantic","hybrid"],"title":"Mode","default":"hybrid"},"filters":{"$ref":"#/components/schemas/SearchFilters"},"limit":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Limit","default":20},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"additionalProperties":false,"type":"object","required":["project_id"],"title":"SearchRequest"},"SearchResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SearchHit"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"mode":{"type":"string","title":"Mode"}},"type":"object","required":["items","next_cursor","mode"],"title":"SearchResponse"},"SignupSourceRequest":{"properties":{"source":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,31}$","title":"Source"}},"additionalProperties":false,"type":"object","required":["source"],"title":"SignupSourceRequest"},"StorageQuota":{"properties":{"used_bytes":{"type":"integer","title":"Used Bytes"},"limit_bytes":{"type":"integer","title":"Limit Bytes"}},"type":"object","required":["used_bytes","limit_bytes"],"title":"StorageQuota"},"UpdateMetadataRequest":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"items":{"type":"string","maxLength":64,"minLength":1},"type":"array","maxItems":50},{"type":"null"}],"title":"Tags"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object","description":"At most 16384 bytes as compact JSON, nested at most 5 levels deep."},{"type":"null"}],"title":"Metadata"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"clear_expires_at":{"type":"boolean","title":"Clear Expires At","default":false}},"additionalProperties":false,"type":"object","title":"UpdateMetadataRequest"},"UploadInstructions":{"properties":{"method":{"type":"string","title":"Method"},"url":{"type":"string","title":"Url"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["method","url","headers","expires_at"],"title":"UploadInstructions"},"UsagePoint":{"properties":{"bucket_start":{"type":"string","format":"date-time","title":"Bucket Start"},"metric":{"type":"string","title":"Metric"},"value":{"type":"integer","title":"Value"}},"type":"object","required":["bucket_start","metric","value"],"title":"UsagePoint"},"UsageSeries":{"properties":{"items":{"items":{"$ref":"#/components/schemas/UsagePoint"},"type":"array","title":"Items"},"granularity":{"type":"string","title":"Granularity"}},"type":"object","required":["items","granularity"],"title":"UsageSeries"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VersionView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"version_number":{"type":"integer","title":"Version Number"},"original_filename":{"type":"string","title":"Original Filename"},"content_type":{"type":"string","title":"Content Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"etag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Etag"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","version_number","original_filename","content_type","size_bytes","etag","sha256","status","created_at"],"title":"VersionView"}}}}