{"openapi":"3.1.0","info":{"title":"CLYC CLI API","version":"1.0.0","summary":"First-party API for CLI and trusted agent workflows.","description":"The CLYC CLI API authenticates with personal bearer API tokens and enforces the same account, project, item, comment, and share permissions as the web app."},"servers":[{"url":"/api/cli/v1","description":"Current deployment"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Resolver"},{"name":"Identity"},{"name":"Accounts"},{"name":"Projects"},{"name":"Items"},{"name":"Uploads"},{"name":"Comments"},{"name":"Shares"}],"paths":{"/resolve":{"get":{"tags":["Resolver"],"operationId":"resolveCliReference","summary":"Resolve any supported CLYC URL or stable id","description":"Accepts CLYC share URLs/tokens, internal file, folder, project, client, and report URLs, and stable UUIDs. Returns the resolved resource, project context where available, preview items for containers, and available CLI actions.","parameters":[{"name":"url","in":"query","required":false,"description":"CLYC URL, share token, internal app path, or stable UUID.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Preview item limit for folder and collection references. Default 25, max 100.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me":{"get":{"tags":["Identity"],"operationId":"getCliMe","summary":"Get authenticated user and token metadata","responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/accounts":{"get":{"tags":["Accounts"],"operationId":"listCliAccounts","summary":"List accounts for the token owner","responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountsResponse"}}}},"401":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects":{"get":{"tags":["Projects"],"operationId":"listCliProjects","summary":"List accessible projects","parameters":[{"name":"accountId","in":"query","required":false,"description":"Filter by account id.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Filter by project status.","schema":{"type":"string"}},{"name":"search","in":"query","required":false,"description":"Case-insensitive name search.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Page size. Default 50, max 200.","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Zero-based offset.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsResponse"}}}},"401":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}":{"get":{"tags":["Projects"],"operationId":"getCliProject","summary":"Get a project","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/items":{"get":{"tags":["Items"],"operationId":"listCliProjectItems","summary":"List or search project items","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}},{"name":"parentId","in":"query","required":false,"description":"Folder id, root, or null.","schema":{"type":"string"}},{"name":"recursive","in":"query","required":false,"description":"Disable parent filtering. Search defaults to project-wide unless parentId or recursive=false is supplied.","schema":{"type":"boolean"}},{"name":"type","in":"query","required":false,"description":"folder, video, image, document, audio, or archive.","schema":{"type":"string"}},{"name":"search","in":"query","required":false,"description":"Case-insensitive name search.","schema":{"type":"string"}},{"name":"includeDeleted","in":"query","required":false,"description":"Include trashed items.","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Page size. Default 100, max 500.","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Zero-based offset.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemsResponse"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/folders":{"post":{"tags":["Items"],"operationId":"createCliFolder","summary":"Create a folder","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFolderRequest"}}}},"responses":{"201":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/items/{itemId}":{"get":{"tags":["Items"],"operationId":"getCliItem","summary":"Get an item","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}},{"name":"includeDeleted","in":"query","required":false,"description":"Allow trashed item lookup.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Items"],"operationId":"updateCliItem","summary":"Update item metadata, name, or parent folder","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateItemRequest"}}}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Items"],"operationId":"deleteCliItem","summary":"Soft delete or permanently delete an item","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}},{"name":"permanent","in":"query","required":false,"description":"Permanently delete an already trashed item.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteItemResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/items/{itemId}/restore":{"post":{"tags":["Items"],"operationId":"restoreCliItem","summary":"Restore a trashed item","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestoreItemRequest"}}}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestoreItemResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/items/{itemId}/download":{"get":{"tags":["Items"],"operationId":"createCliDownloadUrl","summary":"Create a signed download URL","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/items/{itemId}/versions":{"get":{"tags":["Items"],"operationId":"listCliItemVersions","summary":"List item versions","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionsResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/uploads/direct":{"post":{"tags":["Uploads"],"operationId":"createCliDirectUpload","summary":"Create a direct signed upload URL","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectUploadRequest"}}}},"responses":{"201":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectUploadResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/uploads/direct/complete":{"post":{"tags":["Uploads"],"operationId":"completeCliDirectUpload","summary":"Complete a direct file upload","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteDirectUploadRequest"}}}},"responses":{"201":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/uploads/multipart":{"get":{"tags":["Uploads"],"operationId":"listCliMultipartUploadParts","summary":"List uploaded multipart parts","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}},{"name":"key","in":"query","required":false,"description":"Storage key.","schema":{"type":"string"}},{"name":"uploadId","in":"query","required":false,"description":"Storage multipart upload id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultipartPartsResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Uploads"],"operationId":"createCliMultipartUpload","summary":"Create a multipart upload session","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectUploadRequest"}}}},"responses":{"201":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultipartUploadResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Uploads"],"operationId":"abortCliMultipartUpload","summary":"Abort a multipart upload session","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultipartOperationRequest"}}}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/uploads/multipart/parts":{"post":{"tags":["Uploads"],"operationId":"signCliMultipartParts","summary":"Sign multipart part upload URLs","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignPartUrlsRequest"}}}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignPartUrlsResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/uploads/multipart/complete":{"post":{"tags":["Uploads"],"operationId":"completeCliMultipartUpload","summary":"Complete a multipart file upload","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteMultipartUploadRequest"}}}},"responses":{"201":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/items/{itemId}/comments":{"get":{"tags":["Comments"],"operationId":"listCliComments","summary":"List comments for an item or version","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}},{"name":"versionId","in":"query","required":false,"description":"Version item id.","schema":{"type":"string"}},{"name":"versionNumber","in":"query","required":false,"description":"Version number.","schema":{"type":"integer"}},{"name":"includeResolved","in":"query","required":false,"description":"Include resolved comments.","schema":{"type":"boolean"}},{"name":"includeDeleted","in":"query","required":false,"description":"Include deleted comments.","schema":{"type":"boolean"}},{"name":"visibility","in":"query","required":false,"description":"internal, client, or public.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentsResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Comments"],"operationId":"createCliComment","summary":"Create a comment","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCommentRequest"}}}},"responses":{"201":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/comments/{commentId}":{"patch":{"tags":["Comments"],"operationId":"updateCliComment","summary":"Update a comment","parameters":[{"name":"commentId","in":"path","required":true,"description":"Comment id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCommentRequest"}}}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Comments"],"operationId":"deleteCliComment","summary":"Delete a comment","parameters":[{"name":"commentId","in":"path","required":true,"description":"Comment id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/items/{itemId}/shares":{"get":{"tags":["Shares"],"operationId":"listCliShares","summary":"List item share links","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharesResponse"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Shares"],"operationId":"createCliShare","summary":"Create or reuse a share link","parameters":[{"name":"itemId","in":"path","required":true,"description":"Item id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateShareRequest"}}}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareMutationResponse"}}}},"201":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareMutationResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shares/resolve":{"get":{"tags":["Shares"],"operationId":"resolveCliShareReference","summary":"Resolve a public share URL into an authorized item or container","description":"Accepts CLYC share URLs from external tools or the web app. File shares resolve to the latest item version. Folder and collection shares return container metadata plus a preview list; item viewer URLs inside those containers resolve to that specific item.","parameters":[{"name":"url","in":"query","required":false,"description":"CLYC share URL, share path, or raw share token.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Preview item limit for folder and collection shares. Default 25, max 100.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareResolveResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shares/{shareId}":{"patch":{"tags":["Shares"],"operationId":"updateCliShare","summary":"Update a share link","parameters":[{"name":"shareId","in":"path","required":true,"description":"Share link id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateShareRequest"}}}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareMutationResponse"}}}},"400":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Shares"],"operationId":"deleteCliShare","summary":"Delete a share link","parameters":[{"name":"shareId","in":"path","required":true,"description":"Share link id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"403":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"CLYC API token"}},"schemas":{"Error":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"details":{}}},"Pagination":{"type":"object","required":["limit","offset","total"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"MeResponse":{"type":"object","required":["user","token"],"properties":{"user":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"createdAt":{"type":"string","format":"date-time"},"lastSignInAt":{"type":["string","null"],"format":"date-time"}}},"token":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"prefix":{"type":"string"}}}}},"Account":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"is_personal_account":{"type":"boolean"}}},"AccountsResponse":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"joinedAt":{"type":"string","format":"date-time"},"account":{"$ref":"#/components/schemas/Account"}}}}}},"Project":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"account_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string"},"access_mode":{"type":"string"}}},"ProjectsResponse":{"type":"object","properties":{"projects":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"ProjectResponse":{"type":"object","properties":{"project":{"$ref":"#/components/schemas/Project"}}},"ResolveResponse":{"type":"object","additionalProperties":true,"properties":{"reference":{"type":"object","additionalProperties":true,"properties":{"input":{"type":"string"},"targetKind":{"type":"string"}}},"kind":{"type":"string","enum":["item","folder","project","client","report","collection"]},"project":{"anyOf":[{"$ref":"#/components/schemas/Project"},{"type":"null"}]},"item":{"anyOf":[{"$ref":"#/components/schemas/Item"},{"type":"null"}]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"client":{"type":["object","null"],"additionalProperties":true},"report":{"type":["object","null"],"additionalProperties":true},"share":{"anyOf":[{"$ref":"#/components/schemas/ShareLink"},{"type":"null"}]},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"availableActions":{"type":"array","items":{"type":"string"}}}},"Item":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"parent_id":{"type":["string","null"],"format":"uuid"},"name":{"type":"string"},"type":{"type":"string","enum":["folder","video","image","document","audio","archive"]},"file_url":{"type":["string","null"]},"file_size":{"type":["integer","null"]},"mime_type":{"type":["string","null"]},"version_number":{"type":"integer"},"is_latest_version":{"type":"boolean"},"is_deleted":{"type":"boolean"}}},"ItemsResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"ItemResponse":{"type":"object","properties":{"item":{"$ref":"#/components/schemas/Item"}}},"FolderResponse":{"type":"object","properties":{"folder":{"$ref":"#/components/schemas/Item"}}},"CreateFolderRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"parentId":{"type":["string","null"],"format":"uuid"}}},"UpdateItemRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"parentId":{"type":["string","null"],"format":"uuid"},"status":{"type":["string","null"],"enum":["draft","needs_review","in_progress","changes_requested","approved","final","archived",null]},"notes":{"type":["string","null"],"maxLength":20000},"rating":{"type":["integer","null"],"minimum":1,"maximum":5},"assigneeId":{"type":["string","null"],"format":"uuid"},"keywords":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":80}}}},"DeleteItemResponse":{"type":"object","properties":{"success":{"type":"boolean"},"deleted":{},"deleteInfo":{}}},"RestoreItemRequest":{"type":"object","properties":{"resolutionMode":{"type":"string","enum":["check","next_available","original_push_existing"],"default":"next_available"}}},"RestoreItemResponse":{"type":"object","properties":{"success":{"type":"boolean"},"result":{}}},"DownloadResponse":{"type":"object","properties":{"item":{"$ref":"#/components/schemas/Item"},"downloadUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"integer"},"filename":{"type":"string"}}},"VersionsResponse":{"type":"object","properties":{"versions":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}},"DirectUploadRequest":{"type":"object","required":["originalName","size"],"properties":{"parentId":{"type":["string","null"],"format":"uuid"},"originalName":{"type":"string","minLength":1,"maxLength":255},"mime":{"type":"string","maxLength":255,"default":""},"size":{"type":"number","exclusiveMinimum":0}}},"CompleteDirectUploadRequest":{"allOf":[{"$ref":"#/components/schemas/DirectUploadRequest"},{"type":"object","required":["key"],"properties":{"key":{"type":"string","minLength":1}}}]},"DirectUploadResponse":{"type":"object","properties":{"upload":{"type":"object","properties":{"key":{"type":"string"},"uploadUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"integer"},"contentType":{"type":"string"},"itemType":{"type":"string"},"multipartThreshold":{"type":"integer"}}}}},"MultipartUploadResponse":{"type":"object","properties":{"upload":{"type":"object","properties":{"key":{"type":"string"},"uploadId":{"type":"string"},"totalParts":{"type":"integer"},"chunkSize":{"type":"integer"},"contentType":{"type":"string"},"itemType":{"type":"string"}}}}},"MultipartOperationRequest":{"type":"object","required":["key","uploadId"],"properties":{"key":{"type":"string"},"uploadId":{"type":"string"}}},"SignPartUrlsRequest":{"type":"object","required":["key","uploadId","partNumbers"],"properties":{"key":{"type":"string"},"uploadId":{"type":"string"},"partNumbers":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"integer","minimum":1}}}},"SignPartUrlsResponse":{"type":"object","properties":{"urls":{"type":"array","items":{"type":"object","properties":{"partNumber":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}}},"MultipartPartsResponse":{"type":"object","properties":{"parts":{}}},"CompleteMultipartUploadRequest":{"allOf":[{"$ref":"#/components/schemas/CompleteDirectUploadRequest"},{"type":"object","required":["uploadId","parts"],"properties":{"uploadId":{"type":"string"},"parts":{"type":"array","minItems":1,"items":{"type":"object","required":["partNumber","etag"],"properties":{"partNumber":{"type":"integer","minimum":1},"etag":{"type":"string"}}}}}}]},"Comment":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"item_id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"content":{"type":"string"},"is_resolved":{"type":"boolean"},"visibility":{"type":"string","enum":["internal","client","public"]}}},"CommentsResponse":{"type":"object","properties":{"item":{"$ref":"#/components/schemas/Item"},"comments":{"type":"array","items":{"$ref":"#/components/schemas/Comment"}}}},"CommentResponse":{"type":"object","properties":{"comment":{"$ref":"#/components/schemas/Comment"}}},"CreateCommentRequest":{"type":"object","required":["content"],"properties":{"content":{"type":"string","minLength":1,"maxLength":20000},"versionId":{"type":"string","format":"uuid"},"versionNumber":{"type":"integer","minimum":1},"timestampSeconds":{"type":["number","null"],"minimum":0},"endTimestampSeconds":{"type":["number","null"],"minimum":0},"xCoordinate":{"type":["number","null"],"minimum":0,"maximum":1},"yCoordinate":{"type":["number","null"],"minimum":0,"maximum":1},"annotationData":{},"parentCommentId":{"type":["string","null"],"format":"uuid"},"visibility":{"type":"string","enum":["internal","client","public"],"default":"internal"},"commentType":{"type":"string","enum":["general","approval","revision","question"],"default":"general"},"mentionUserIds":{"type":"array","maxItems":50,"items":{"type":"string","format":"uuid"}}}},"UpdateCommentRequest":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":20000},"isResolved":{"type":"boolean"},"visibility":{"type":"string","enum":["internal","client","public"]}}},"ShareLink":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid"},"token":{"type":"string"},"share_type":{"type":"string","enum":["file","folder","collection"]},"is_active":{"type":"boolean"},"shareUrl":{"type":["string","null"],"format":"uri"}}},"ShareReference":{"type":"object","properties":{"input":{"type":"string"},"token":{"type":"string"},"itemId":{"type":["string","null"],"format":"uuid"},"folderId":{"type":["string","null"],"format":"uuid"},"targetKind":{"type":"string","enum":["root","item","folder","token"]}}},"ShareSettings":{"type":"object","properties":{"allowComments":{"type":"boolean","default":true},"allowDownload":{"type":"boolean","default":true},"allowEmbed":{"type":"boolean","default":false}}},"SharesResponse":{"type":"object","properties":{"shares":{"type":"array","items":{"$ref":"#/components/schemas/ShareLink"}}}},"CreateShareRequest":{"type":"object","properties":{"shareType":{"type":"string","enum":["file","folder","collection"]},"itemIds":{"type":"array","items":{"type":"string","format":"uuid"}},"linkTitle":{"type":["string","null"],"maxLength":255},"settings":{"$ref":"#/components/schemas/ShareSettings"},"expiresIn":{"type":"string","enum":["7d","30d","90d","never"]},"expiresAt":{"type":["string","null"],"format":"date-time"}}},"UpdateShareRequest":{"type":"object","properties":{"linkTitle":{"type":["string","null"],"maxLength":255},"settings":{"$ref":"#/components/schemas/ShareSettings"},"isActive":{"type":"boolean"},"expiresIn":{"type":"string","enum":["7d","30d","90d","never"]},"expiresAt":{"type":["string","null"],"format":"date-time"},"regenerateToken":{"type":"boolean","default":false}}},"ShareMutationResponse":{"type":"object","properties":{"share":{"$ref":"#/components/schemas/ShareLink"},"shareUrl":{"type":["string","null"],"format":"uri"},"reused":{"type":"boolean"}}},"ShareResolveResponse":{"type":"object","properties":{"reference":{"$ref":"#/components/schemas/ShareReference"},"kind":{"type":"string","enum":["item","folder","collection"]},"share":{"$ref":"#/components/schemas/ShareLink"},"project":{"$ref":"#/components/schemas/Project"},"item":{"oneOf":[{"$ref":"#/components/schemas/Item"},{"type":"null"}]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"pagination":{"oneOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]}}},"SuccessResponse":{"type":"object","properties":{"success":{"type":"boolean"}}}}}}