{"openapi":"3.0.0","paths":{"/v1/me":{"get":{"description":"Workspace, plan, key, reach and the quota of the current period. Use it to test a connection: it is not metered.","operationId":"PublicApiMeController_me","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMeResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"The key and its space","tags":["Account"]}},"/v1/buckets":{"get":{"description":"The buckets the key reaches, in the order they were connected.","operationId":"PublicApiBucketsController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBucketPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List buckets","tags":["Buckets"]}},"/v1/buckets/{bucketId}/files":{"get":{"description":"One level of a folder: folders first, then files. Each group lists its plain items in the order asked and then its encrypted items in a fixed order of their own, so where an encrypted item appears says nothing about its name or date. Encrypted items come in their opaque shape; listing inside an encrypted folder answers API_ENCRYPTED_CONTENT. A page can hold fewer items than limit: follow nextCursor until it is null. A folder created straight at the provider can take up to 5 minutes to appear for a key that already listed it as missing.","operationId":"PublicApiBucketsController_files","parameters":[{"name":"bucketId","required":true,"in":"path","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"prefix","required":false,"in":"query","description":"The folder to list; empty or absent lists the root of the bucket","schema":{"maxLength":1024,"example":"invoices/2026/","type":"string"}},{"name":"sort","required":false,"in":"query","description":"Folders always come first, and encrypted items follow the plain ones of their group","schema":{"default":"name","type":"string","enum":["name","modified"]}},{"name":"order","required":false,"in":"query","description":"asc by default for name, desc for modified","schema":{"type":"string","enum":["asc","desc"]}},{"name":"includeHidden","required":false,"in":"query","description":"Include items hidden in Nubbo","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFilePageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List a folder","tags":["Buckets"]}},"/v1/buckets/{bucketId}/folders":{"post":{"description":"Creates the folder at the provider and in Nubbo, with any missing parent folders inside the reach of the key (at most 20 new levels). Inside an encrypted folder it answers API_ENCRYPTED_DESTINATION. Parallel calls for one path with conflict=fail and no Idempotency-Key can all answer 201 with the same single folder; send an Idempotency-Key to get one answer. Idempotency-Key is honoured.","operationId":"PublicApiBucketsController_createFolder","parameters":[{"name":"bucketId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateFolderDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, FILES_RESERVED_FOLDER_NAME, API_PATH_TOO_DEEP","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_RESERVED_FOLDER_NAME":{"summary":"That folder name is reserved by Nubbo","value":{"statusCode":400,"message":"That folder name is reserved by Nubbo","error":"Bad Request","code":"FILES_RESERVED_FOLDER_NAME","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_PATH_TOO_DEEP":{"summary":"This path has too many new folders; create the folders first","value":{"statusCode":400,"message":"This path has too many new folders; create the folders first","error":"Bad Request","code":"API_PATH_TOO_DEEP","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BUCKET_ACCESS_INSUFFICIENT, BILLING_BUCKET_DISABLED, BUCKET_S3_ACCESS_DENIED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_ACCESS_INSUFFICIENT":{"summary":"Your access to this bucket does not allow this action","value":{"statusCode":403,"message":"Your access to this bucket does not allow this action","error":"Forbidden","code":"BUCKET_ACCESS_INSUFFICIENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_S3_ACCESS_DENIED":{"summary":"Access denied. Please verify your IAM permissions.","value":{"statusCode":403,"message":"Access denied. Please verify your IAM permissions.","error":"Forbidden","code":"BUCKET_S3_ACCESS_DENIED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, BUCKET_MOVE_IN_PROGRESS, API_ENCRYPTED_DESTINATION, API_NAME_TAKEN","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_NAME_TAKEN":{"summary":"An item with this name already exists here; send another conflict mode or name","value":{"statusCode":409,"message":"An item with this name already exists here; send another conflict mode or name","error":"Conflict","code":"API_NAME_TAKEN","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"502":{"description":"BUCKET_S3_BUCKET_NOT_FOUND, API_PROVIDER_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_S3_BUCKET_NOT_FOUND":{"summary":"Bucket not found. Please verify the bucket name and region.","value":{"statusCode":502,"message":"Bucket not found. Please verify the bucket name and region.","error":"BAD_GATEWAY","code":"BUCKET_S3_BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_PROVIDER_FAILED":{"summary":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","value":{"statusCode":502,"message":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","error":"BAD_GATEWAY","code":"API_PROVIDER_FAILED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Create a folder","tags":["Buckets"]}},"/v1/buckets/{bucketId}/uploads":{"post":{"description":"The file travels straight from you to the storage provider; Nubbo never receives its content. Up to 5 GB the answer carries one presigned URL: PUT the bytes there before expiresAt, then call POST /v1/uploads/{uploadId}/complete. Above 5 GB, or with multipart=true (from 5 MiB), sign parts with POST /v1/uploads/{uploadId}/parts, PUT each part, then complete. Until complete runs, the file does not appear in Nubbo; complete checks that the object has the size announced here. Inside an encrypted folder it answers API_ENCRYPTED_DESTINATION. A replay with the same Idempotency-Key returns the same uploadId with a freshly signed URL.","operationId":"PublicApiBucketsController_createUpload","parameters":[{"name":"bucketId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateUploadDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUploadResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, FILES_RESERVED_FOLDER_NAME, API_PATH_TOO_DEEP, API_UPLOAD_MULTIPART_TOO_SMALL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_RESERVED_FOLDER_NAME":{"summary":"That folder name is reserved by Nubbo","value":{"statusCode":400,"message":"That folder name is reserved by Nubbo","error":"Bad Request","code":"FILES_RESERVED_FOLDER_NAME","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_PATH_TOO_DEEP":{"summary":"This path has too many new folders; create the folders first","value":{"statusCode":400,"message":"This path has too many new folders; create the folders first","error":"Bad Request","code":"API_PATH_TOO_DEEP","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_UPLOAD_MULTIPART_TOO_SMALL":{"summary":"Multipart uploads start at 5 MiB; send this file in one request","value":{"statusCode":400,"message":"Multipart uploads start at 5 MiB; send this file in one request","error":"Bad Request","code":"API_UPLOAD_MULTIPART_TOO_SMALL","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BUCKET_ACCESS_INSUFFICIENT, BILLING_BUCKET_DISABLED, BUCKET_S3_ACCESS_DENIED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_ACCESS_INSUFFICIENT":{"summary":"Your access to this bucket does not allow this action","value":{"statusCode":403,"message":"Your access to this bucket does not allow this action","error":"Forbidden","code":"BUCKET_ACCESS_INSUFFICIENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_S3_ACCESS_DENIED":{"summary":"Access denied. Please verify your IAM permissions.","value":{"statusCode":403,"message":"Access denied. Please verify your IAM permissions.","error":"Forbidden","code":"BUCKET_S3_ACCESS_DENIED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, BUCKET_MOVE_IN_PROGRESS, API_ENCRYPTED_DESTINATION, API_ENCRYPTED_CONTENT, API_NAME_TAKEN","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_NAME_TAKEN":{"summary":"An item with this name already exists here; send another conflict mode or name","value":{"statusCode":409,"message":"An item with this name already exists here; send another conflict mode or name","error":"Conflict","code":"API_NAME_TAKEN","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"502":{"description":"BUCKET_S3_BUCKET_NOT_FOUND, API_PROVIDER_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_S3_BUCKET_NOT_FOUND":{"summary":"Bucket not found. Please verify the bucket name and region.","value":{"statusCode":502,"message":"Bucket not found. Please verify the bucket name and region.","error":"BAD_GATEWAY","code":"BUCKET_S3_BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_PROVIDER_FAILED":{"summary":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","value":{"statusCode":502,"message":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","error":"BAD_GATEWAY","code":"API_PROVIDER_FAILED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Start an upload","tags":["Buckets"]}},"/v1/files/move":{"post":{"description":"Moves up to 1,000 items of one bucket into a folder, of the same bucket or another one. Small moves of files finish in the request (200); folder moves, large selections and moves to another bucket run in the background and answer 202 with an operationId. Another bucket works when the two buckets can copy to each other at the provider; otherwise API_CROSS_BUCKET_NEEDS_BROWSER, and the move has to be done in the Nubbo app. Encrypted items answer API_ENCRYPTED_CONTENT and encrypted destinations API_ENCRYPTED_DESTINATION; a folder with encrypted content inside moves only within its bucket. Ids that do not exist or are out of reach answer API_FILE_NOT_FOUND with details.fileIds, and nothing moves.","operationId":"PublicApiFilesController_move","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMoveDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMoveResultResponseDto"}}}},"202":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiQueuedResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, API_MOVE_ONE_BUCKET, API_MOVE_INTO_ITSELF","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_MOVE_ONE_BUCKET":{"summary":"Move files from one bucket per request","value":{"statusCode":400,"message":"Move files from one bucket per request","error":"Bad Request","code":"API_MOVE_ONE_BUCKET","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_MOVE_INTO_ITSELF":{"summary":"A folder cannot be moved into itself","value":{"statusCode":400,"message":"A folder cannot be moved into itself","error":"Bad Request","code":"API_MOVE_INTO_ITSELF","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED, TEAM_ZK_MOVE_REFUSED, TEAM_ZK_MOVE_OUT_REFUSED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"TEAM_ZK_MOVE_REFUSED":{"summary":"Moves into and across encrypted parts of the team go in separate requests; files and folders move across with their keys rewrapped by the browser, and plain files and folders move in through the encryption step","value":{"statusCode":403,"message":"Moves into and across encrypted parts of the team go in separate requests; files and folders move across with their keys rewrapped by the browser, and plain files and folders move in through the encryption step","error":"Forbidden","code":"TEAM_ZK_MOVE_REFUSED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"TEAM_ZK_MOVE_OUT_REFUSED":{"summary":"Encrypted team content leaves its encrypted part for an unencrypted place only once it is decrypted there; decrypt it first","value":{"statusCode":403,"message":"Encrypted team content leaves its encrypted part for an unencrypted place only once it is decrypted there; decrypt it first","error":"Forbidden","code":"TEAM_ZK_MOVE_OUT_REFUSED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND, BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, BUCKET_MOVE_IN_PROGRESS, API_ENCRYPTED_CONTENT, API_ENCRYPTED_DESTINATION, API_NAME_TAKEN, FILES_RENAME_IN_PROGRESS, API_CROSS_BUCKET_NEEDS_BROWSER","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_NAME_TAKEN":{"summary":"An item with this name already exists here; send another conflict mode or name","value":{"statusCode":409,"message":"An item with this name already exists here; send another conflict mode or name","error":"Conflict","code":"API_NAME_TAKEN","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_RENAME_IN_PROGRESS":{"summary":"Another rename or move of this path is still running","value":{"statusCode":409,"message":"Another rename or move of this path is still running","error":"Conflict","code":"FILES_RENAME_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_CROSS_BUCKET_NEEDS_BROWSER":{"summary":"These buckets cannot copy to each other directly; move the files in the Nubbo app","value":{"statusCode":409,"message":"These buckets cannot copy to each other directly; move the files in the Nubbo app","error":"Conflict","code":"API_CROSS_BUCKET_NEEDS_BROWSER","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Move files and folders","tags":["Files"]}},"/v1/files/trash":{"post":{"description":"Up to 1,000 items, from any buckets the key reaches. A folder goes to the trash with everything inside. Items stay in the trash until it is emptied in Nubbo; the API never deletes for good. Items Nubbo cannot trash right now are listed in failed with their code.","operationId":"PublicApiFilesController_trash","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileIdsDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkResultResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT, BUCKET_MOVE_IN_PROGRESS, FILES_RENAME_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_RENAME_IN_PROGRESS":{"summary":"Another rename or move of this path is still running","value":{"statusCode":409,"message":"Another rename or move of this path is still running","error":"Conflict","code":"FILES_RENAME_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Move to the trash","tags":["Files"]}},"/v1/files/search":{"get":{"description":"Files and folders by name, kind, extension, label, size or date, within the reach of the key. Send q or at least one filter. Encrypted and trashed items are never returned. A page can hold fewer items than limit: follow nextCursor until it is null.","operationId":"PublicApiFilesController_search","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"q","required":false,"in":"query","description":"Words of the name; each word matches a part of it","schema":{"maxLength":200,"example":"invoice march","type":"string"}},{"name":"bucketId","required":false,"in":"query","description":"Search one bucket only","schema":{"format":"uuid","type":"string"}},{"name":"prefix","required":false,"in":"query","description":"Search inside this folder and its subfolders; needs bucketId","schema":{"maxLength":1024,"example":"invoices/","type":"string"}},{"name":"kind","required":false,"in":"query","description":"Comma separated kinds","schema":{"example":"documents,images","type":"array","items":{"type":"string","enum":["folders","images","videos","audio","documents","code","archives","others"]}}},{"name":"extension","required":false,"in":"query","description":"Comma separated file extensions, without the dot","schema":{"maxItems":20,"example":"pdf,docx","type":"array","items":{"type":"string"}}},{"name":"labelIds","required":false,"in":"query","description":"Comma separated label ids; files with every one of them","schema":{"type":"array","items":{"type":"string","format":"uuid"}}},{"name":"sizeMin","required":false,"in":"query","description":"Minimum size in bytes","schema":{"minimum":0,"type":"number"}},{"name":"sizeMax","required":false,"in":"query","description":"Maximum size in bytes","schema":{"minimum":0,"type":"number"}},{"name":"modifiedFrom","required":false,"in":"query","description":"Modified at or after","schema":{"format":"date-time","type":"string"}},{"name":"modifiedTo","required":false,"in":"query","description":"Modified at or before","schema":{"format":"date-time","type":"string"}},{"name":"sort","required":false,"in":"query","description":"With q, better matches come first and this orders each group","schema":{"default":"modified","type":"string","enum":["name","modified"]}},{"name":"order","required":false,"in":"query","description":"asc by default for name, desc for modified","schema":{"type":"string","enum":["asc","desc"]}},{"name":"includeHidden","required":false,"in":"query","description":"Include items hidden in Nubbo","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFilePageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID, FILES_SEARCH_CRITERIA_REQUIRED, FILES_SEARCH_SIZE_RANGE_INVALID, FILES_SEARCH_DATE_RANGE_INVALID, FILES_SEARCH_PREFIX_REQUIRES_BUCKET","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_SEARCH_CRITERIA_REQUIRED":{"summary":"Search requires a query or at least one filter","value":{"statusCode":400,"message":"Search requires a query or at least one filter","error":"Bad Request","code":"FILES_SEARCH_CRITERIA_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_SEARCH_SIZE_RANGE_INVALID":{"summary":"Minimum size cannot exceed maximum size","value":{"statusCode":400,"message":"Minimum size cannot exceed maximum size","error":"Bad Request","code":"FILES_SEARCH_SIZE_RANGE_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_SEARCH_DATE_RANGE_INVALID":{"summary":"Start date cannot be after end date","value":{"statusCode":400,"message":"Start date cannot be after end date","error":"Bad Request","code":"FILES_SEARCH_DATE_RANGE_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_SEARCH_PREFIX_REQUIRES_BUCKET":{"summary":"Folder scope requires exactly one bucket","value":{"statusCode":400,"message":"Folder scope requires exactly one bucket","error":"Bad Request","code":"FILES_SEARCH_PREFIX_REQUIRES_BUCKET","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"408":{"description":"FILES_SEARCH_TIMEOUT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"FILES_SEARCH_TIMEOUT":{"summary":"Search took too long; narrow the query and try again","value":{"statusCode":408,"message":"Search took too long; narrow the query and try again","error":"Request Timeout","code":"FILES_SEARCH_TIMEOUT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Search files","tags":["Files"]}},"/v1/files/{fileId}":{"get":{"description":"Any item the key reaches, also hidden or trashed ones. An encrypted item comes in its opaque shape.","operationId":"PublicApiFilesController_get","parameters":[{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get a file or folder","tags":["Files"]},"patch":{"description":"Renames in place. A folder rename that Nubbo runs in the background answers 202 with an operationId. Encrypted items answer API_ENCRYPTED_CONTENT.","operationId":"PublicApiFilesController_rename","parameters":[{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiRenameDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileResponseDto"}}}},"202":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiQueuedResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, FILES_RESERVED_FOLDER_NAME","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_RESERVED_FOLDER_NAME":{"summary":"That folder name is reserved by Nubbo","value":{"statusCode":400,"message":"That folder name is reserved by Nubbo","error":"Bad Request","code":"FILES_RESERVED_FOLDER_NAME","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, BUCKET_MOVE_IN_PROGRESS, API_ENCRYPTED_CONTENT, API_NAME_TAKEN, FILES_RENAME_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_NAME_TAKEN":{"summary":"An item with this name already exists here; send another conflict mode or name","value":{"statusCode":409,"message":"An item with this name already exists here; send another conflict mode or name","error":"Conflict","code":"API_NAME_TAKEN","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_RENAME_IN_PROGRESS":{"summary":"Another rename or move of this path is still running","value":{"statusCode":409,"message":"Another rename or move of this path is still running","error":"Conflict","code":"FILES_RENAME_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Rename a file or folder","tags":["Files"]}},"/v1/files/{fileId}/download-link":{"post":{"description":"A presigned link straight to the storage provider; the file never passes through Nubbo. Works with read keys. The link keeps working until it expires, even if the key is revoked meanwhile, so ask for the shortest expiry you need. In a team the download appears in the activity log; personal spaces do not record downloads. A trashed file answers API_FILE_NOT_FOUND: restore it first. Idempotency-Key is accepted and ignored.","operationId":"PublicApiFilesController_downloadLink","parameters":[{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiDownloadLinkDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiDownloadLinkResponseDto"}}}},"400":{"description":"API_FOLDER_NOT_DOWNLOADABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FOLDER_NOT_DOWNLOADABLE":{"summary":"Folders have no download link; list the folder and ask for a link per file","value":{"statusCode":400,"message":"Folders have no download link; list the folder and ask for a link per file","error":"Bad Request","code":"API_FOLDER_NOT_DOWNLOADABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get a download link","tags":["Files"]}},"/v1/files/{fileId}/labels/{labelId}":{"post":{"description":"Needs write access to the path of the item. Adding a label it already has changes nothing. Create labels with POST /v1/labels.","operationId":"PublicApiFilesController_addLabel","parameters":[{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}},{"name":"labelId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileLabelsResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND, LABEL_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_NOT_FOUND":{"summary":"Label not found","value":{"statusCode":404,"message":"Label not found","error":"Not Found","code":"LABEL_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT, BUCKET_MOVE_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Add a label to a file","tags":["Files"]},"delete":{"description":"Needs write access to the path of the item. The label itself stays.","operationId":"PublicApiFilesController_removeLabel","parameters":[{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}},{"name":"labelId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileLabelsResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND, LABEL_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_NOT_FOUND":{"summary":"Label not found","value":{"statusCode":404,"message":"Label not found","error":"Not Found","code":"LABEL_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT, BUCKET_MOVE_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Remove a label from a file","tags":["Files"]}},"/v1/trash":{"get":{"description":"Trashed files and folders the key reaches, most recently trashed first. A trashed folder is listed once, without its contents.","operationId":"PublicApiTrashController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"bucketId","required":false,"in":"query","description":"Trash of one bucket only","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFilePageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List the trash","tags":["Trash"]}},"/v1/trash/restore":{"post":{"description":"Up to 1,000 trashed items, from any buckets the key reaches, back to where they were. An item inside a trashed folder answers in failed: restore the folder. Items Nubbo cannot restore right now are listed in failed with their code.","operationId":"PublicApiTrashController_restore","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileIdsDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkResultResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT, BUCKET_MOVE_IN_PROGRESS, FILES_RENAME_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_RENAME_IN_PROGRESS":{"summary":"Another rename or move of this path is still running","value":{"statusCode":409,"message":"Another rename or move of this path is still running","error":"Conflict","code":"FILES_RENAME_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Restore from the trash","tags":["Trash"]}},"/v1/labels":{"get":{"description":"Every label of the space, by name. Labels belong to the whole space; encrypted labels come in their opaque shape.","operationId":"PublicApiLabelsController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLabelPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List labels","tags":["Labels"]},"post":{"description":"Labels belong to the whole space, so this needs a read and write key for the whole space (API_KEY_WHOLE_SPACE_REQUIRED otherwise). Names are unique in the space, ignoring case. Idempotency-Key is honoured.","operationId":"PublicApiLabelsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateLabelDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLabelResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, LABEL_NAME_EXISTS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_NAME_EXISTS":{"summary":"A label with this name already exists","value":{"statusCode":400,"message":"A label with this name already exists","error":"Bad Request","code":"LABEL_NAME_EXISTS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_WHOLE_SPACE_REQUIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_WHOLE_SPACE_REQUIRED":{"summary":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","value":{"statusCode":403,"message":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","error":"Forbidden","code":"API_KEY_WHOLE_SPACE_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"LABEL_GROUP_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"LABEL_GROUP_NOT_FOUND":{"summary":"Label group not found","value":{"statusCode":404,"message":"Label group not found","error":"Not Found","code":"LABEL_GROUP_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Create a label","tags":["Labels"]}},"/v1/labels/{labelId}":{"patch":{"description":"Labels belong to the whole space, so this needs a read and write key for the whole space (API_KEY_WHOLE_SPACE_REQUIRED otherwise). Send only the fields to change. Encrypted labels answer API_ENCRYPTED_CONTENT.","operationId":"PublicApiLabelsController_update","parameters":[{"name":"labelId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUpdateLabelDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLabelResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, LABEL_NAME_EXISTS, LABEL_ROUTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_NAME_EXISTS":{"summary":"A label with this name already exists","value":{"statusCode":400,"message":"A label with this name already exists","error":"Bad Request","code":"LABEL_NAME_EXISTS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_ROUTED":{"summary":"An automation writes this label by name; rename its category first","value":{"statusCode":400,"message":"An automation writes this label by name; rename its category first","error":"Bad Request","code":"LABEL_ROUTED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_WHOLE_SPACE_REQUIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_WHOLE_SPACE_REQUIRED":{"summary":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","value":{"statusCode":403,"message":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","error":"Forbidden","code":"API_KEY_WHOLE_SPACE_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"LABEL_NOT_FOUND, LABEL_GROUP_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"LABEL_NOT_FOUND":{"summary":"Label not found","value":{"statusCode":404,"message":"Label not found","error":"Not Found","code":"LABEL_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_GROUP_NOT_FOUND":{"summary":"Label group not found","value":{"statusCode":404,"message":"Label group not found","error":"Not Found","code":"LABEL_GROUP_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Change a label","tags":["Labels"]},"delete":{"description":"Labels belong to the whole space, so this needs a read and write key for the whole space (API_KEY_WHOLE_SPACE_REQUIRED otherwise). The label is removed from every file; the files stay. Encrypted labels answer API_ENCRYPTED_CONTENT: delete them in Nubbo.","operationId":"PublicApiLabelsController_remove","parameters":[{"name":"labelId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_WHOLE_SPACE_REQUIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_WHOLE_SPACE_REQUIRED":{"summary":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","value":{"statusCode":403,"message":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","error":"Forbidden","code":"API_KEY_WHOLE_SPACE_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"LABEL_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"LABEL_NOT_FOUND":{"summary":"Label not found","value":{"statusCode":404,"message":"Label not found","error":"Not Found","code":"LABEL_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT, BUCKET_MOVE_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Delete a label","tags":["Labels"]}},"/v1/labels/{labelId}/merge":{"post":{"description":"Labels belong to the whole space, so this needs a read and write key for the whole space (API_KEY_WHOLE_SPACE_REQUIRED otherwise). Files with this label get the label in intoId, and this label is deleted. Encrypted labels answer API_ENCRYPTED_CONTENT.","operationId":"PublicApiLabelsController_merge","parameters":[{"name":"labelId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMergeLabelDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMergedLabelResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, LABEL_MERGE_INVALID, LABEL_ROUTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_MERGE_INVALID":{"summary":"Labels cannot be merged into one of themselves","value":{"statusCode":400,"message":"Labels cannot be merged into one of themselves","error":"Bad Request","code":"LABEL_MERGE_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"LABEL_ROUTED":{"summary":"An automation writes this label by name; rename its category first","value":{"statusCode":400,"message":"An automation writes this label by name; rename its category first","error":"Bad Request","code":"LABEL_ROUTED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_WHOLE_SPACE_REQUIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_WHOLE_SPACE_REQUIRED":{"summary":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","value":{"statusCode":403,"message":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","error":"Forbidden","code":"API_KEY_WHOLE_SPACE_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"LABEL_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"LABEL_NOT_FOUND":{"summary":"Label not found","value":{"statusCode":404,"message":"Label not found","error":"Not Found","code":"LABEL_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT, BUCKET_MOVE_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_MOVE_IN_PROGRESS":{"summary":"This bucket is being moved to another space","value":{"statusCode":409,"message":"This bucket is being moved to another space","error":"Conflict","code":"BUCKET_MOVE_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Merge a label into another","tags":["Labels"]}},"/v1/label-groups":{"get":{"description":"The label groups of the space, oldest first, to place labels in with groupId. Encrypted groups come in their opaque shape.","operationId":"PublicApiLabelGroupsController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLabelGroupPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List label groups","tags":["Labels"]}},"/v1/projects":{"get":{"description":"Projects with at least one folder the key reaches, by name.","operationId":"PublicApiProjectsController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"default":"active","type":"string","enum":["active","archived"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiProjectPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List projects","tags":["Projects"]}},"/v1/projects/{projectId}":{"get":{"description":"The project, its folders within the reach of the key (encrypted folders without their path) and how many links, file requests, galleries, embeds and rules it holds.","operationId":"PublicApiProjectsController_get","parameters":[{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiProjectDetailResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"PROJECT_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"PROJECT_NOT_FOUND":{"summary":"Project not found","value":{"statusCode":404,"message":"Project not found","error":"Not Found","code":"PROJECT_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get a project","tags":["Projects"]}},"/v1/projects/{projectId}/items":{"post":{"description":"Needs a read and write key for the whole space (API_KEY_WHOLE_SPACE_REQUIRED otherwise). A folder must exist in Nubbo and not be in the trash; an empty path adds the whole bucket. Adding a folder gives the people the project is shared with access to it, as in the Nubbo app. Encrypted folders and resources answer API_ENCRYPTED_CONTENT. Answers the project.","operationId":"PublicApiProjectsController_addItems","parameters":[{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiProjectItemsDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiProjectDetailResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, PROJECT_FOLDERS_LIMIT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"PROJECT_FOLDERS_LIMIT":{"summary":"This project already has the maximum number of folders","value":{"statusCode":400,"message":"This project already has the maximum number of folders","error":"Bad Request","code":"PROJECT_FOLDERS_LIMIT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_WHOLE_SPACE_REQUIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_WHOLE_SPACE_REQUIRED":{"summary":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","value":{"statusCode":403,"message":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","error":"Forbidden","code":"API_KEY_WHOLE_SPACE_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"PROJECT_NOT_FOUND, PROJECT_ITEM_NOT_FOUND, BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"PROJECT_NOT_FOUND":{"summary":"Project not found","value":{"statusCode":404,"message":"Project not found","error":"Not Found","code":"PROJECT_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"PROJECT_ITEM_NOT_FOUND":{"summary":"One of the items to add to the project was not found","value":{"statusCode":404,"message":"One of the items to add to the project was not found","error":"Not Found","code":"PROJECT_ITEM_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Add folders and resources to a project","tags":["Projects"]},"delete":{"description":"Needs a read and write key for the whole space. The folders and resources themselves stay; people the project is shared with lose the access it gave them. Items not in the project are ignored. Answers the project.","operationId":"PublicApiProjectsController_removeItems","parameters":[{"name":"projectId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiProjectItemsDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiProjectDetailResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, PROJECT_FOLDERS_LIMIT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"PROJECT_FOLDERS_LIMIT":{"summary":"This project already has the maximum number of folders","value":{"statusCode":400,"message":"This project already has the maximum number of folders","error":"Bad Request","code":"PROJECT_FOLDERS_LIMIT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_WHOLE_SPACE_REQUIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_WHOLE_SPACE_REQUIRED":{"summary":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","value":{"statusCode":403,"message":"Only a read and write API key for the whole space can do this; labels and project items belong to the whole space","error":"Forbidden","code":"API_KEY_WHOLE_SPACE_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"PROJECT_NOT_FOUND, PROJECT_ITEM_NOT_FOUND, BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"PROJECT_NOT_FOUND":{"summary":"Project not found","value":{"statusCode":404,"message":"Project not found","error":"Not Found","code":"PROJECT_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"PROJECT_ITEM_NOT_FOUND":{"summary":"One of the items to add to the project was not found","value":{"statusCode":404,"message":"One of the items to add to the project was not found","error":"Not Found","code":"PROJECT_ITEM_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Remove folders and resources from a project","tags":["Projects"]}},"/v1/uploads/{uploadId}/parts":{"post":{"description":"Multipart uploads only: presigned PUT URLs for up to 100 parts per call, valid for one hour. Every part but the last has exactly partSize bytes. Ask again for any part whose URL expired. Idempotency-Key is accepted; a replay signs again.","operationId":"PublicApiUploadsController_parts","parameters":[{"name":"uploadId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUploadPartsDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUploadPartsResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, API_UPLOAD_NOT_MULTIPART, API_UPLOAD_PART_OUT_OF_RANGE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_UPLOAD_NOT_MULTIPART":{"summary":"This upload is a single request; only multipart uploads take parts or abort","value":{"statusCode":400,"message":"This upload is a single request; only multipart uploads take parts or abort","error":"Bad Request","code":"API_UPLOAD_NOT_MULTIPART","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_UPLOAD_PART_OUT_OF_RANGE":{"summary":"This part number is outside the parts of this upload","value":{"statusCode":400,"message":"This part number is outside the parts of this upload","error":"Bad Request","code":"API_UPLOAD_PART_OUT_OF_RANGE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_UPLOAD_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_UPLOAD_NOT_FOUND":{"summary":"This upload does not exist or belongs to another API key; start a new one","value":{"statusCode":404,"message":"This upload does not exist or belongs to another API key; start a new one","error":"Not Found","code":"API_UPLOAD_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Sign upload parts","tags":["Uploads"]}},"/v1/uploads/{uploadId}/complete":{"post":{"description":"Call it once the bytes are at the provider. Nubbo checks the object, indexes it and records the upload in the activity log, then answers the file. Multipart uploads need every part first (API_UPLOAD_PARTS_MISSING lists the missing ones). Single uploads can be completed for 24 hours after they start. Idempotency-Key is honoured.","operationId":"PublicApiUploadsController_complete","parameters":[{"name":"uploadId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiFileResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, API_UPLOAD_PARTS_MISSING","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_UPLOAD_PARTS_MISSING":{"summary":"Some parts of this upload are missing; upload every part, then complete it","value":{"statusCode":400,"message":"Some parts of this upload are missing; upload every part, then complete it","error":"Bad Request","code":"API_UPLOAD_PARTS_MISSING","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED, BUCKET_S3_ACCESS_DENIED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_S3_ACCESS_DENIED":{"summary":"Access denied. Please verify your IAM permissions.","value":{"statusCode":403,"message":"Access denied. Please verify your IAM permissions.","error":"Forbidden","code":"BUCKET_S3_ACCESS_DENIED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_UPLOAD_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_UPLOAD_NOT_FOUND":{"summary":"This upload does not exist or belongs to another API key; start a new one","value":{"statusCode":404,"message":"This upload does not exist or belongs to another API key; start a new one","error":"Not Found","code":"API_UPLOAD_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_DESTINATION, API_UPLOAD_NOT_RECEIVED, API_UPLOAD_SIZE_MISMATCH, FILES_UPLOAD_MOVED_REFUSED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_UPLOAD_NOT_RECEIVED":{"summary":"The provider has not received this file yet; send it to the upload URL, then complete it","value":{"statusCode":409,"message":"The provider has not received this file yet; send it to the upload URL, then complete it","error":"Conflict","code":"API_UPLOAD_NOT_RECEIVED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_UPLOAD_SIZE_MISMATCH":{"summary":"The file at the provider does not have the size this upload announced; send it again, then complete it","value":{"statusCode":409,"message":"The file at the provider does not have the size this upload announced; send it again, then complete it","error":"Conflict","code":"API_UPLOAD_SIZE_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILES_UPLOAD_MOVED_REFUSED":{"summary":"The folder of this upload moved and the file cannot follow it there; upload it again in its new place","value":{"statusCode":409,"message":"The folder of this upload moved and the file cannot follow it there; upload it again in its new place","error":"Conflict","code":"FILES_UPLOAD_MOVED_REFUSED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"502":{"description":"BUCKET_S3_BUCKET_NOT_FOUND, API_PROVIDER_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_S3_BUCKET_NOT_FOUND":{"summary":"Bucket not found. Please verify the bucket name and region.","value":{"statusCode":502,"message":"Bucket not found. Please verify the bucket name and region.","error":"BAD_GATEWAY","code":"BUCKET_S3_BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_PROVIDER_FAILED":{"summary":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","value":{"statusCode":502,"message":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","error":"BAD_GATEWAY","code":"API_PROVIDER_FAILED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Complete an upload","tags":["Uploads"]}},"/v1/uploads/{uploadId}":{"delete":{"description":"Discards the parts already sent to the provider. Single uploads need no abort.","operationId":"PublicApiUploadsController_abort","parameters":[{"name":"uploadId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Aborted"},"400":{"description":"API_UPLOAD_NOT_MULTIPART","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_UPLOAD_NOT_MULTIPART":{"summary":"This upload is a single request; only multipart uploads take parts or abort","value":{"statusCode":400,"message":"This upload is a single request; only multipart uploads take parts or abort","error":"Bad Request","code":"API_UPLOAD_NOT_MULTIPART","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BUCKET_S3_ACCESS_DENIED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_S3_ACCESS_DENIED":{"summary":"Access denied. Please verify your IAM permissions.","value":{"statusCode":403,"message":"Access denied. Please verify your IAM permissions.","error":"Forbidden","code":"BUCKET_S3_ACCESS_DENIED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_UPLOAD_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_UPLOAD_NOT_FOUND":{"summary":"This upload does not exist or belongs to another API key; start a new one","value":{"statusCode":404,"message":"This upload does not exist or belongs to another API key; start a new one","error":"Not Found","code":"API_UPLOAD_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"502":{"description":"BUCKET_S3_BUCKET_NOT_FOUND, API_PROVIDER_FAILED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_S3_BUCKET_NOT_FOUND":{"summary":"Bucket not found. Please verify the bucket name and region.","value":{"statusCode":502,"message":"Bucket not found. Please verify the bucket name and region.","error":"BAD_GATEWAY","code":"BUCKET_S3_BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_PROVIDER_FAILED":{"summary":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","value":{"statusCode":502,"message":"The storage provider refused the request or did not answer; check the bucket connection in Nubbo and try again","error":"BAD_GATEWAY","code":"API_PROVIDER_FAILED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Abort a multipart upload","tags":["Uploads"]}},"/v1/operations/{operationId}":{"get":{"description":"Moves, renames and transfers that Nubbo runs in the background answer 202 with an operationId; poll it here, at most once every few seconds. Only the key that started it can read it. The work runs only while the key that started it still works and still reaches every path involved: if the key is revoked, expires, is blocked or narrowed, loses write access, or the team is suspended or read-only, the operation fails with API_KEY_REVOKED. Before the work starts nothing moves; during a run Nubbo checks the key at least once a minute (and every 500 items of a transfer), and items already finished stay where they arrived while a folder in mid-copy is left where it was.","operationId":"PublicApiOperationsController_get","parameters":[{"name":"operationId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOperationResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_OPERATION_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_OPERATION_NOT_FOUND":{"summary":"This operation does not exist or was started by another API key","value":{"statusCode":404,"message":"This operation does not exist or was started by another API key","error":"Not Found","code":"API_OPERATION_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get an operation","tags":["Operations"]}},"/v1/links":{"get":{"description":"Share links of files and folders the key reaches, newest first. Encrypted links come in their opaque shape.","operationId":"PublicApiLinksController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"fileId","required":false,"in":"query","description":"Only the links of this file or folder","schema":{"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61","type":"string"}},{"name":"bucketId","required":false,"in":"query","schema":{"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60","type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["active","paused","expired"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLinkPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND, BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List share links","tags":["Links"]},"post":{"description":"A public link to a file or folder, optionally with a password, an expiry and a download limit. The answer carries the url to send. In a team where members cannot share outside, it answers WORKSPACE_SHARING_DISABLED. Encrypted items answer API_ENCRYPTED_CONTENT. Idempotency-Key is honoured.","operationId":"PublicApiLinksController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateLinkDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLinkResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, WORKSPACE_SHARING_DISABLED, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Create a share link","tags":["Links"]}},"/v1/links/{linkId}":{"get":{"operationId":"PublicApiLinksController_get","parameters":[{"name":"linkId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLinkResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"SHARE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARE_NOT_FOUND":{"summary":"Share not found","value":{"statusCode":404,"message":"Share not found","error":"Not Found","code":"SHARE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get a share link","tags":["Links"]},"patch":{"description":"Pause or resume it (active), change or remove its password, expiry or download limit. Send only the fields to change.","operationId":"PublicApiLinksController_update","parameters":[{"name":"linkId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUpdateLinkDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLinkResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"SHARE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARE_NOT_FOUND":{"summary":"Share not found","value":{"statusCode":404,"message":"Share not found","error":"Not Found","code":"SHARE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Change a share link","tags":["Links"]},"delete":{"description":"The link stops working at once. The shared files stay where they are.","operationId":"PublicApiLinksController_remove","parameters":[{"name":"linkId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"SHARE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARE_NOT_FOUND":{"summary":"Share not found","value":{"statusCode":404,"message":"Share not found","error":"Not Found","code":"SHARE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Delete a share link","tags":["Links"]}},"/v1/inboxes":{"get":{"description":"File requests (inboxes) whose folder the key reaches, newest first. Encrypted inboxes come in their opaque shape.","operationId":"PublicApiInboxesController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"bucketId","required":false,"in":"query","schema":{"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60","type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["active","paused","expired"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiInboxPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List file requests","tags":["Inboxes"]},"post":{"description":"A public upload page whose files land in the folder you choose, optionally with a password, an expiry and limits. The answer carries the url to send. Plans limit how many file requests a space has (BILLING_FILE_REQUEST_LIMIT_REACHED). Inside an encrypted folder it answers API_ENCRYPTED_DESTINATION. Idempotency-Key is honoured.","operationId":"PublicApiInboxesController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateInboxDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiInboxResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED, WORKSPACE_SHARING_DISABLED, BILLING_FILE_REQUEST_LIMIT_REACHED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_FILE_REQUEST_LIMIT_REACHED":{"summary":"Your plan file request limit has been reached","value":{"statusCode":403,"message":"Your plan file request limit has been reached","error":"Forbidden","code":"BILLING_FILE_REQUEST_LIMIT_REACHED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_DESTINATION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Create a file request","tags":["Inboxes"]}},"/v1/inboxes/{inboxId}":{"get":{"operationId":"PublicApiInboxesController_get","parameters":[{"name":"inboxId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiInboxResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"FILE_REQUEST_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"FILE_REQUEST_NOT_FOUND":{"summary":"File request not found","value":{"statusCode":404,"message":"File request not found","error":"Not Found","code":"FILE_REQUEST_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get a file request","tags":["Inboxes"]},"patch":{"description":"Close it (active: false) or reopen it, rename it, move its folder or change its limits. Send only the fields to change.","operationId":"PublicApiInboxesController_update","parameters":[{"name":"inboxId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUpdateInboxDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiInboxResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"FILE_REQUEST_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"FILE_REQUEST_NOT_FOUND":{"summary":"File request not found","value":{"statusCode":404,"message":"File request not found","error":"Not Found","code":"FILE_REQUEST_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT, API_ENCRYPTED_DESTINATION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Change a file request","tags":["Inboxes"]},"delete":{"description":"The upload page stops working at once. Files already received stay in the bucket.","operationId":"PublicApiInboxesController_remove","parameters":[{"name":"inboxId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"FILE_REQUEST_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"FILE_REQUEST_NOT_FOUND":{"summary":"File request not found","value":{"statusCode":404,"message":"File request not found","error":"Not Found","code":"FILE_REQUEST_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Delete a file request","tags":["Inboxes"]}},"/v1/inboxes/{inboxId}/uploads":{"get":{"description":"Files received through the file request, newest first, with their file ids. Whether the sender identified themselves is shown; who they are is kept in Nubbo. Encrypted uploads, and uploads whose file is no longer where it arrived, come in their opaque shape. Uploads received before Nubbo kept their exact key are matched through the request folder, so after the folder changed they may show as gone.","operationId":"PublicApiInboxesController_uploads","parameters":[{"name":"inboxId","required":true,"in":"path","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiInboxUploadPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"FILE_REQUEST_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"FILE_REQUEST_NOT_FOUND":{"summary":"File request not found","value":{"statusCode":404,"message":"File request not found","error":"Not Found","code":"FILE_REQUEST_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List files received","tags":["Inboxes"]}},"/v1/galleries":{"get":{"description":"Galleries whose folder the key reaches, newest first. Encrypted galleries come in their opaque shape.","operationId":"PublicApiGalleriesController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"bucketId","required":false,"in":"query","schema":{"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60","type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["active","paused","expired"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiGalleryPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List galleries","tags":["Galleries"]},"post":{"description":"A public photo and video gallery of a folder, with the core options of the gallery editor; branding, theme, sets and the rest stay in Nubbo. Plans limit how many galleries a space has (BILLING_GALLERY_LIMIT_REACHED). A folder under encryption answers API_ENCRYPTED_DESTINATION. Idempotency-Key is honoured.","operationId":"PublicApiGalleriesController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateGalleryDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiGalleryResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, API_COVER_OUTSIDE_GALLERY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_COVER_OUTSIDE_GALLERY":{"summary":"The cover must be a file inside the gallery folder","value":{"statusCode":400,"message":"The cover must be a file inside the gallery folder","error":"Bad Request","code":"API_COVER_OUTSIDE_GALLERY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, WORKSPACE_SHARING_DISABLED, BILLING_BUCKET_DISABLED, BILLING_GALLERY_LIMIT_REACHED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_GALLERY_LIMIT_REACHED":{"summary":"Your plan gallery limit has been reached","value":{"statusCode":403,"message":"Your plan gallery limit has been reached","error":"Forbidden","code":"BILLING_GALLERY_LIMIT_REACHED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"API_FILE_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_FILE_NOT_FOUND":{"summary":"This file does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This file does not exist or this API key cannot reach it","error":"Not Found","code":"API_FILE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_DESTINATION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Create a gallery","tags":["Galleries"]}},"/v1/galleries/{galleryId}":{"get":{"operationId":"PublicApiGalleriesController_get","parameters":[{"name":"galleryId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiGalleryResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"GALLERY_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"GALLERY_NOT_FOUND":{"summary":"Gallery not found","value":{"statusCode":404,"message":"Gallery not found","error":"Not Found","code":"GALLERY_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get a gallery","tags":["Galleries"]},"patch":{"description":"Send only the fields to change; null clears. active false pauses the gallery.","operationId":"PublicApiGalleriesController_update","parameters":[{"name":"galleryId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUpdateGalleryDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiGalleryResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, API_COVER_OUTSIDE_GALLERY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_COVER_OUTSIDE_GALLERY":{"summary":"The cover must be a file inside the gallery folder","value":{"statusCode":400,"message":"The cover must be a file inside the gallery folder","error":"Bad Request","code":"API_COVER_OUTSIDE_GALLERY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, BILLING_BUCKET_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BILLING_BUCKET_DISABLED":{"summary":"This bucket is disabled by your current plan","value":{"statusCode":403,"message":"This bucket is disabled by your current plan","error":"Forbidden","code":"BILLING_BUCKET_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"GALLERY_NOT_FOUND, BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"GALLERY_NOT_FOUND":{"summary":"Gallery not found","value":{"statusCode":404,"message":"Gallery not found","error":"Not Found","code":"GALLERY_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Change a gallery","tags":["Galleries"]},"delete":{"description":"The gallery page stops working at once. The photos stay in the bucket.","operationId":"PublicApiGalleriesController_remove","parameters":[{"name":"galleryId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"GALLERY_NOT_FOUND, BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"GALLERY_NOT_FOUND":{"summary":"Gallery not found","value":{"statusCode":404,"message":"Gallery not found","error":"Not Found","code":"GALLERY_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Delete a gallery","tags":["Galleries"]}},"/v1/embeds":{"get":{"description":"Embeds whose source the key reaches, newest first. Lists carry no snippet; get one embed for it.","operationId":"PublicApiEmbedsController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"kind","required":false,"in":"query","schema":{"type":"string","enum":["inbox","explorer","shared"]}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["active","paused","expired"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiEmbedPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List embeds","tags":["Embeds"]},"post":{"description":"An embeddable upload box (inbox, with inboxId), file explorer (explorer, with bucketId and path) or shared item (shared, with linkId). config is optional: the minimal call is {\"kind\":\"inbox\",\"name\":\"Upload box\",\"inboxId\":\"…\"}, and a partial config is merged over the default of the kind. The answer carries the snippet to paste. Encrypted sources answer API_ENCRYPTED_CONTENT. Idempotency-Key is honoured.","operationId":"PublicApiEmbedsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateEmbedDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiEmbedResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, EMBED_CONFIG_INVALID, EMBED_SOURCE_NOT_FOUND, EMBED_SOURCE_NOT_ELIGIBLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"EMBED_CONFIG_INVALID":{"summary":"The embed configuration is not valid","value":{"statusCode":400,"message":"The embed configuration is not valid","error":"Bad Request","code":"EMBED_CONFIG_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"EMBED_SOURCE_NOT_FOUND":{"summary":"The source of this embed no longer exists","value":{"statusCode":400,"message":"The source of this embed no longer exists","error":"Bad Request","code":"EMBED_SOURCE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"EMBED_SOURCE_NOT_ELIGIBLE":{"summary":"This source cannot be embedded","value":{"statusCode":400,"message":"This source cannot be embedded","error":"Bad Request","code":"EMBED_SOURCE_NOT_ELIGIBLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, WORKSPACE_SHARING_DISABLED, EMBED_NOT_ENTITLED, EMBED_LIMIT_REACHED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"EMBED_NOT_ENTITLED":{"summary":"Embeds are not included in your plan","value":{"statusCode":403,"message":"Embeds are not included in your plan","error":"Forbidden","code":"EMBED_NOT_ENTITLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"EMBED_LIMIT_REACHED":{"summary":"You have reached the maximum number of active embeds","value":{"statusCode":403,"message":"You have reached the maximum number of active embeds","error":"Forbidden","code":"EMBED_LIMIT_REACHED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"FILE_REQUEST_NOT_FOUND, SHARE_NOT_FOUND, BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"FILE_REQUEST_NOT_FOUND":{"summary":"File request not found","value":{"statusCode":404,"message":"File request not found","error":"Not Found","code":"FILE_REQUEST_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"SHARE_NOT_FOUND":{"summary":"Share not found","value":{"statusCode":404,"message":"Share not found","error":"Not Found","code":"SHARE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Create an embed","tags":["Embeds"]}},"/v1/embeds/{embedId}":{"get":{"operationId":"PublicApiEmbedsController_get","parameters":[{"name":"embedId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiEmbedResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"EMBED_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"EMBED_NOT_FOUND":{"summary":"Embed not found","value":{"statusCode":404,"message":"Embed not found","error":"Not Found","code":"EMBED_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get an embed","tags":["Embeds"]},"patch":{"description":"Pause or resume it (paused), rename it, change its sites, expiry, password (explorer only) or config, which is merged over the current one.","operationId":"PublicApiEmbedsController_update","parameters":[{"name":"embedId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUpdateEmbedDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiEmbedResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID, EMBED_CONFIG_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"EMBED_CONFIG_INVALID":{"summary":"The embed configuration is not valid","value":{"statusCode":400,"message":"The embed configuration is not valid","error":"Bad Request","code":"EMBED_CONFIG_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, EMBED_LIMIT_REACHED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"EMBED_LIMIT_REACHED":{"summary":"You have reached the maximum number of active embeds","value":{"statusCode":403,"message":"You have reached the maximum number of active embeds","error":"Forbidden","code":"EMBED_LIMIT_REACHED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"EMBED_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"EMBED_NOT_FOUND":{"summary":"Embed not found","value":{"statusCode":404,"message":"Embed not found","error":"Not Found","code":"EMBED_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Change an embed","tags":["Embeds"]},"delete":{"description":"The embed stops working on every site at once. The source stays.","operationId":"PublicApiEmbedsController_remove","parameters":[{"name":"embedId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"EMBED_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"EMBED_NOT_FOUND":{"summary":"Embed not found","value":{"statusCode":404,"message":"Embed not found","error":"Not Found","code":"EMBED_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Delete an embed","tags":["Embeds"]}},"/v1/automations":{"get":{"description":"Rules whose folder the key reaches, newest first.","operationId":"PublicApiAutomationsController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiAutomationPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List automation rules","tags":["Automations"]},"post":{"description":"The same rule definition the Nubbo app saves (trigger, folder, action and its settings). Actions that use Nubbo AI (TAG, RENAME, ROUTE, SENSITIVE_SCAN, AI_PROMPT) answer API_KEY_NOT_ALLOWED. No AI action runs through a key: a rule that uses Nubbo AI, made in Nubbo, runs with the AI consent its creator gave in that space (in a team, the consent of that person for the team, not the one of their own space) and stays paused while that person withdraws it. The rule runs as the person who created the key (the owner once that person is gone), with the access of that person; it pauses if that person can no longer run it. Revoking the key does not stop the rule: rules belong to the space. SHARE_LINK rules create links under the identity of the rule creator and need sharing outside to be allowed. Paths inside encrypted folders answer API_ENCRYPTED_DESTINATION. Idempotency-Key is honoured.","operationId":"PublicApiAutomationsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiCreateAutomationDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiAutomationResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_NOT_ALLOWED, WORKSPACE_SHARING_DISABLED, AUTOMATION_NOT_ENTITLED, AUTOMATION_RULE_LIMIT_REACHED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_NOT_ALLOWED":{"summary":"API keys cannot do this; do it in the Nubbo app","value":{"statusCode":403,"message":"API keys cannot do this; do it in the Nubbo app","error":"Forbidden","code":"API_KEY_NOT_ALLOWED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"AUTOMATION_NOT_ENTITLED":{"summary":"Your plan does not include automations","value":{"statusCode":403,"message":"Your plan does not include automations","error":"Forbidden","code":"AUTOMATION_NOT_ENTITLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"AUTOMATION_RULE_LIMIT_REACHED":{"summary":"You have reached the automation rule limit of your plan","value":{"statusCode":403,"message":"You have reached the automation rule limit of your plan","error":"Forbidden","code":"AUTOMATION_RULE_LIMIT_REACHED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND, API_FOLDER_NOT_FOUND, FILE_REQUEST_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_FOLDER_NOT_FOUND":{"summary":"This folder does not exist or this API key cannot reach it","value":{"statusCode":404,"message":"This folder does not exist or this API key cannot reach it","error":"Not Found","code":"API_FOLDER_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"FILE_REQUEST_NOT_FOUND":{"summary":"File request not found","value":{"statusCode":404,"message":"File request not found","error":"Not Found","code":"FILE_REQUEST_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_DESTINATION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Create an automation rule","tags":["Automations"]}},"/v1/automations/{ruleId}":{"get":{"operationId":"PublicApiAutomationsController_get","parameters":[{"name":"ruleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiAutomationResponseDto"}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"AUTOMATION_RULE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"AUTOMATION_RULE_NOT_FOUND":{"summary":"Automation rule not found","value":{"statusCode":404,"message":"Automation rule not found","error":"Not Found","code":"AUTOMATION_RULE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Get an automation rule","tags":["Automations"]},"patch":{"description":"Send only the fields to change; trigger, action and bucket cannot change. Changing, resuming or deleting a rule needs every folder of the rule (watched folder, inbox and destinations) inside the reach of the key; otherwise it answers as not found. Pausing needs only the watched folder. Destinations outside the reach of the key are hidden in answers (destinationFolder: null), and a rule you can read but not change answers as not found on change, resume and delete; a null destination is the sign. Rules that use Nubbo AI answer API_KEY_NOT_ALLOWED, except isActive false.","operationId":"PublicApiAutomationsController_update","parameters":[{"name":"ruleId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiUpdateAutomationDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiAutomationResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_NOT_ALLOWED, WORKSPACE_SHARING_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_NOT_ALLOWED":{"summary":"API keys cannot do this; do it in the Nubbo app","value":{"statusCode":403,"message":"API keys cannot do this; do it in the Nubbo app","error":"Forbidden","code":"API_KEY_NOT_ALLOWED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"AUTOMATION_RULE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"AUTOMATION_RULE_NOT_FOUND":{"summary":"Automation rule not found","value":{"statusCode":404,"message":"Automation rule not found","error":"Not Found","code":"AUTOMATION_RULE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_DESTINATION, AUTOMATION_CREATOR_REMOVED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"AUTOMATION_CREATOR_REMOVED":{"summary":"This automation has no creator any more; reassign it before changing it","value":{"statusCode":409,"message":"This automation has no creator any more; reassign it before changing it","error":"Conflict","code":"AUTOMATION_CREATOR_REMOVED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Change an automation rule","tags":["Automations"]},"delete":{"description":"The rule stops at once. Files it already handled stay as they are.","operationId":"PublicApiAutomationsController_remove","parameters":[{"name":"ruleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"AUTOMATION_RULE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"AUTOMATION_RULE_NOT_FOUND":{"summary":"Automation rule not found","value":{"statusCode":404,"message":"Automation rule not found","error":"Not Found","code":"AUTOMATION_RULE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Delete an automation rule","tags":["Automations"]}},"/v1/automations/{ruleId}/pause":{"post":{"operationId":"PublicApiAutomationsController_pause","parameters":[{"name":"ruleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiAutomationResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_NOT_ALLOWED, WORKSPACE_SHARING_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_NOT_ALLOWED":{"summary":"API keys cannot do this; do it in the Nubbo app","value":{"statusCode":403,"message":"API keys cannot do this; do it in the Nubbo app","error":"Forbidden","code":"API_KEY_NOT_ALLOWED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"AUTOMATION_RULE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"AUTOMATION_RULE_NOT_FOUND":{"summary":"Automation rule not found","value":{"statusCode":404,"message":"Automation rule not found","error":"Not Found","code":"AUTOMATION_RULE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_DESTINATION, AUTOMATION_CREATOR_REMOVED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"AUTOMATION_CREATOR_REMOVED":{"summary":"This automation has no creator any more; reassign it before changing it","value":{"statusCode":409,"message":"This automation has no creator any more; reassign it before changing it","error":"Conflict","code":"AUTOMATION_CREATOR_REMOVED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Pause an automation rule","tags":["Automations"]}},"/v1/automations/{ruleId}/resume":{"post":{"description":"Rules that use Nubbo AI answer API_KEY_NOT_ALLOWED: resume them in Nubbo.","operationId":"PublicApiAutomationsController_resume","parameters":[{"name":"ruleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiAutomationResponseDto"}}}},"400":{"description":"API_IDEMPOTENCY_KEY_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_KEY_INVALID":{"summary":"Idempotency-Key must be 1 to 255 visible ASCII characters","value":{"statusCode":400,"message":"Idempotency-Key must be 1 to 255 visible ASCII characters","error":"Bad Request","code":"API_IDEMPOTENCY_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED, API_KEY_READ_ONLY, WORKSPACE_READ_ONLY, API_KEY_NOT_ALLOWED, WORKSPACE_SHARING_DISABLED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_READ_ONLY":{"summary":"This API key can only read; give it write access in Nubbo to make changes","value":{"statusCode":403,"message":"This API key can only read; give it write access in Nubbo to make changes","error":"Forbidden","code":"API_KEY_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_READ_ONLY":{"summary":"This workspace is read-only until its subscription is paid","value":{"statusCode":403,"message":"This workspace is read-only until its subscription is paid","error":"Forbidden","code":"WORKSPACE_READ_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_NOT_ALLOWED":{"summary":"API keys cannot do this; do it in the Nubbo app","value":{"statusCode":403,"message":"API keys cannot do this; do it in the Nubbo app","error":"Forbidden","code":"API_KEY_NOT_ALLOWED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SHARING_DISABLED":{"summary":"In this team members cannot share outside the team","value":{"statusCode":403,"message":"In this team members cannot share outside the team","error":"Forbidden","code":"WORKSPACE_SHARING_DISABLED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"AUTOMATION_RULE_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"AUTOMATION_RULE_NOT_FOUND":{"summary":"Automation rule not found","value":{"statusCode":404,"message":"Automation rule not found","error":"Not Found","code":"AUTOMATION_RULE_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_IDEMPOTENCY_IN_PROGRESS, API_ENCRYPTED_DESTINATION, AUTOMATION_CREATOR_REMOVED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_IN_PROGRESS":{"summary":"A request with this Idempotency-Key is still running","value":{"statusCode":409,"message":"A request with this Idempotency-Key is still running","error":"Conflict","code":"API_IDEMPOTENCY_IN_PROGRESS","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_ENCRYPTED_DESTINATION":{"summary":"This destination is encrypted; add content to it in Nubbo","value":{"statusCode":409,"message":"This destination is encrypted; add content to it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_DESTINATION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"AUTOMATION_CREATOR_REMOVED":{"summary":"This automation has no creator any more; reassign it before changing it","value":{"statusCode":409,"message":"This automation has no creator any more; reassign it before changing it","error":"Conflict","code":"AUTOMATION_CREATOR_REMOVED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"422":{"description":"API_IDEMPOTENCY_MISMATCH","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_IDEMPOTENCY_MISMATCH":{"summary":"This Idempotency-Key was already used with another request","value":{"statusCode":422,"message":"This Idempotency-Key was already used with another request","error":"Unprocessable Entity","code":"API_IDEMPOTENCY_MISMATCH","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"Resume an automation rule","tags":["Automations"]}},"/v1/activity":{"get":{"description":"What happened to files, labels, projects, the trash, links, file requests, galleries, automations and embeds inside the reach of the key, newest first. Saved searches are personal and never listed. Filter by types, bucketId or apiKeyId (what one key did). Encrypted rows carry no path, name or detail.","operationId":"PublicApiActivityController_list","parameters":[{"name":"limit","required":false,"in":"query","description":"Items per page","schema":{"minimum":1,"maximum":100,"default":50,"example":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","description":"The nextCursor of the previous page, sent with the same parameters","schema":{"maxLength":2048,"type":"string"}},{"name":"types","required":false,"in":"query","description":"Comma-separated activity types; all public types when absent. Types no longer in the catalog (SAVED_SEARCH_CREATED, SAVED_SEARCH_RENAMED, SAVED_SEARCH_DELETED) are accepted and match nothing","schema":{"maxItems":117,"type":"array","items":{"type":"string","enum":["FILE_UPLOADED","FOLDER_CREATED","FILE_RENAMED","FILES_MOVED","FILE_EDITED","TRANSFER_COMPLETED","TRANSFER_FAILED","TRANSFER_CANCELLED","TRANSFER_PAUSED","TRANSFER_RESUMED","FILE_OPERATION_FAILED","FOLDER_SYNC_REQUESTED","AI_DOCUMENT_CREATED","FILE_DOWNLOADED","FILES_DOWNLOADED","FAVORITE_ADDED","FAVORITE_REMOVED","FILES_HIDDEN","FILES_UNHIDDEN","LABELS_ASSIGNED","LABELS_UNASSIGNED","LABEL_CREATED","LABEL_EDITED","LABEL_RENAMED","LABEL_DELETED","LABELS_MERGED","LABEL_GROUP_CREATED","LABEL_GROUP_EDITED","LABEL_GROUP_RENAMED","LABEL_GROUP_DELETED","BUCKET_GROUP_CREATED","BUCKET_GROUP_EDITED","BUCKET_GROUP_RENAMED","BUCKET_GROUP_DELETED","BUCKET_MOVED_TO_GROUP","PROJECT_CREATED","PROJECT_RENAMED","PROJECT_EDITED","PROJECT_ARCHIVED","PROJECT_UNARCHIVED","PROJECT_DELETED","PROJECT_ITEMS_ADDED","PROJECT_ITEMS_REMOVED","TRASH_SENT","TRASH_RESTORED","TRASH_DELETED","TRASH_PURGED","SHARE_CREATED","SHARE_EDITED","SHARE_REVOKED","SHARE_EXPIRED","SHARE_FIRST_VISIT","SHARE_DOWNLOAD_CLAIMED","SHARE_ZK_CONVERTED","INVITE_CREATED","INVITE_EDITED","INVITE_REVOKED","INVITE_ACCEPTED","INVITE_EXPIRED","INVITE_FIRST_ACCESS","INVITE_RECEIVED","INVITE_DOWNLOAD","INVITE_LEFT","SHARE_APPROVAL_REQUESTED","SHARE_APPROVAL_APPROVED","SHARE_APPROVAL_REJECTED","SHARE_APPROVAL_EXPIRED","SHARE_APPROVAL_CANCELLED","FILE_REQUEST_CREATED","FILE_REQUEST_EDITED","FILE_REQUEST_DELETED","FILE_REQUEST_EXPIRED","FILE_REQUEST_FIRST_VISIT","FILE_REQUEST_VISITOR_REGISTERED","FILE_REQUEST_RECEIVED","FILE_REQUEST_ZK_ADOPTED","FILE_REQUEST_ZK_CONVERTED","GALLERY_CREATED","GALLERY_EDITED","GALLERY_DELETED","GALLERY_EXPIRED","GALLERY_FIRST_VISIT","GALLERY_VISITOR_REGISTERED","GALLERY_PHOTO_LIKED","GALLERY_DOWNLOAD_CLAIMED","GALLERY_ZIP_DOWNLOADED","GALLERY_ZK_CONVERTED","GALLERY_COMMENTED","GALLERY_CLIENT_INVITED","GALLERY_DELIVERY_SENT","GALLERY_CURATED","GALLERY_INDEXED","AUTOMATION_RULE_CREATED","AUTOMATION_RULE_EDITED","AUTOMATION_RULE_DELETED","AUTOMATION_RULE_PAUSED","AUTOMATION_RULE_RESUMED","AUTOMATION_EXECUTED","RULE_REASSIGNED","RULE_PAUSED_CREATOR_REMOVED","EMBED_CREATED","EMBED_EDITED","EMBED_DUPLICATED","EMBED_PAUSED","EMBED_RESUMED","EMBED_TOKEN_ROTATED","EMBED_DELETED","EMBED_FIRST_VISIT","EMBED_EXPIRED","EMBED_FILE_UPLOADED","EMBED_FOLDER_CREATED","EMBED_FILE_DELETED","EMBEDS_PLAN_PAUSED","EMBEDS_PLAN_RESUMED"]}}},{"name":"bucketId","required":false,"in":"query","schema":{"format":"uuid","type":"string"}},{"name":"apiKeyId","required":false,"in":"query","description":"Only what this API key did","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiActivityPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"List activity","tags":["Activity"]}},"/v1/triggers/new-files":{"get":{"description":"Files uploaded in Nubbo, through a file request or an embed, optionally in one bucket and under a folder. Without since it answers the latest 50 newest first; the first poll of a new flow, or of a new filter on a flow, seeds it and counts no events, so switching a flow on never bills the past. With since it answers what came after, oldest first, up to 100 (hasMore says more are waiting). Each item carries its own cursor, which resumes right after that item when sent as since. Items show up about 5 seconds after they happen. Poll each trigger at most once a minute (API_TRIGGER_TOO_FREQUENT with Retry-After). A key can poll each trigger with up to 20 combinations of flow and filter in 24 hours (API_TRIGGER_FLOWS_LIMIT). Polls do not use requests; each item counts as one trigger event the first time it is delivered to this key, filter and flow. When the monthly events left are fewer than the new items, it delivers as many as are left with hasMore true, and answers API_QUOTA_EXCEEDED once none are left; flows polling at the same moment can go a few events over. truncated: true means the cursor is older than the activity the plan keeps. Encrypted content never fires a trigger. An item is delivered once every activity recorded before it is safely stored; an activity write slower than 5 seconds could still be missed.","operationId":"PublicApiTriggersController_newFiles","parameters":[{"name":"since","required":false,"in":"query","description":"The cursor of the last poll. Without it the latest items come newest first, to show or to seed a flow; with it the items after it come oldest first.","schema":{"maxLength":2048,"type":"string"}},{"name":"bucketId","required":false,"in":"query","schema":{"format":"uuid","type":"string"}},{"name":"prefix","required":false,"in":"query","description":"Only files under this folder (in the chosen bucket, or in any bucket)","schema":{"maxLength":1024,"example":"invoices/","type":"string"}},{"name":"x-nubbo-flow","required":false,"in":"header","description":"An id for the flow polling, when several flows share one key and the same filter, so each keeps its own pace and count. Up to 20 combinations of flow and filter per key and trigger polled in the last 24 hours (API_TRIGGER_FLOWS_LIMIT); a flow not polled for 30 days starts again as new.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTriggerPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID, API_TRIGGER_FLOWS_LIMIT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_TRIGGER_FLOWS_LIMIT":{"summary":"This key polled this trigger with 20 combinations of flow and filter in the last 24 hours; reuse one of them","value":{"statusCode":400,"message":"This key polled this trigger with 20 combinations of flow and filter in the last 24 hours; reuse one of them","error":"Bad Request","code":"API_TRIGGER_FLOWS_LIMIT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"BUCKET_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"BUCKET_NOT_FOUND":{"summary":"Bucket not found","value":{"statusCode":404,"message":"Bucket not found","error":"Not Found","code":"BUCKET_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES, API_TRIGGER_TOO_FREQUENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_TRIGGER_TOO_FREQUENT":{"summary":"Poll this trigger at most once a minute; wait for the time in Retry-After","value":{"statusCode":429,"message":"Poll this trigger at most once a minute; wait for the time in Retry-After","error":"Too Many Requests","code":"API_TRIGGER_TOO_FREQUENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"New files","tags":["Triggers"]}},"/v1/triggers/new-inbox-uploads":{"get":{"description":"Files sent to a file request, optionally one file request. Without since it answers the latest 50 newest first; the first poll of a new flow, or of a new filter on a flow, seeds it and counts no events, so switching a flow on never bills the past. With since it answers what came after, oldest first, up to 100 (hasMore says more are waiting). Each item carries its own cursor, which resumes right after that item when sent as since. Items show up about 5 seconds after they happen. Poll each trigger at most once a minute (API_TRIGGER_TOO_FREQUENT with Retry-After). A key can poll each trigger with up to 20 combinations of flow and filter in 24 hours (API_TRIGGER_FLOWS_LIMIT). Polls do not use requests; each item counts as one trigger event the first time it is delivered to this key, filter and flow. When the monthly events left are fewer than the new items, it delivers as many as are left with hasMore true, and answers API_QUOTA_EXCEEDED once none are left; flows polling at the same moment can go a few events over. truncated: true means the cursor is older than the activity the plan keeps. Encrypted content never fires a trigger. An item is delivered once every activity recorded before it is safely stored; an activity write slower than 5 seconds could still be missed.","operationId":"PublicApiTriggersController_newInboxUploads","parameters":[{"name":"since","required":false,"in":"query","description":"The cursor of the last poll. Without it the latest items come newest first, to show or to seed a flow; with it the items after it come oldest first.","schema":{"maxLength":2048,"type":"string"}},{"name":"inboxId","required":false,"in":"query","description":"Only this file request","schema":{"format":"uuid","type":"string"}},{"name":"x-nubbo-flow","required":false,"in":"header","description":"An id for the flow polling, when several flows share one key and the same filter, so each keeps its own pace and count. Up to 20 combinations of flow and filter per key and trigger polled in the last 24 hours (API_TRIGGER_FLOWS_LIMIT); a flow not polled for 30 days starts again as new.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTriggerPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID, API_TRIGGER_FLOWS_LIMIT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_TRIGGER_FLOWS_LIMIT":{"summary":"This key polled this trigger with 20 combinations of flow and filter in the last 24 hours; reuse one of them","value":{"statusCode":400,"message":"This key polled this trigger with 20 combinations of flow and filter in the last 24 hours; reuse one of them","error":"Bad Request","code":"API_TRIGGER_FLOWS_LIMIT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"404":{"description":"FILE_REQUEST_NOT_FOUND","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"FILE_REQUEST_NOT_FOUND":{"summary":"File request not found","value":{"statusCode":404,"message":"File request not found","error":"Not Found","code":"FILE_REQUEST_NOT_FOUND","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"409":{"description":"API_ENCRYPTED_CONTENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_ENCRYPTED_CONTENT":{"summary":"This item is encrypted; open it in Nubbo","value":{"statusCode":409,"message":"This item is encrypted; open it in Nubbo","error":"Conflict","code":"API_ENCRYPTED_CONTENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES, API_TRIGGER_TOO_FREQUENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_TRIGGER_TOO_FREQUENT":{"summary":"Poll this trigger at most once a minute; wait for the time in Retry-After","value":{"statusCode":429,"message":"Poll this trigger at most once a minute; wait for the time in Retry-After","error":"Too Many Requests","code":"API_TRIGGER_TOO_FREQUENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"New file request uploads","tags":["Triggers"]}},"/v1/triggers/new-activity":{"get":{"description":"Any activity of the types you choose, from the same catalog as List activity. Without since it answers the latest 50 newest first; the first poll of a new flow, or of a new filter on a flow, seeds it and counts no events, so switching a flow on never bills the past. With since it answers what came after, oldest first, up to 100 (hasMore says more are waiting). Each item carries its own cursor, which resumes right after that item when sent as since. Items show up about 5 seconds after they happen. Poll each trigger at most once a minute (API_TRIGGER_TOO_FREQUENT with Retry-After). A key can poll each trigger with up to 20 combinations of flow and filter in 24 hours (API_TRIGGER_FLOWS_LIMIT). Polls do not use requests; each item counts as one trigger event the first time it is delivered to this key, filter and flow. When the monthly events left are fewer than the new items, it delivers as many as are left with hasMore true, and answers API_QUOTA_EXCEEDED once none are left; flows polling at the same moment can go a few events over. truncated: true means the cursor is older than the activity the plan keeps. Encrypted content never fires a trigger. An item is delivered once every activity recorded before it is safely stored; an activity write slower than 5 seconds could still be missed.","operationId":"PublicApiTriggersController_newActivity","parameters":[{"name":"since","required":false,"in":"query","description":"The cursor of the last poll. Without it the latest items come newest first, to show or to seed a flow; with it the items after it come oldest first.","schema":{"maxLength":2048,"type":"string"}},{"name":"types","required":false,"in":"query","description":"Comma-separated activity types; all public types when absent. Types no longer in the catalog (SAVED_SEARCH_CREATED, SAVED_SEARCH_RENAMED, SAVED_SEARCH_DELETED) are accepted and match nothing","schema":{"maxItems":117,"type":"array","items":{"type":"string","enum":["FILE_UPLOADED","FOLDER_CREATED","FILE_RENAMED","FILES_MOVED","FILE_EDITED","TRANSFER_COMPLETED","TRANSFER_FAILED","TRANSFER_CANCELLED","TRANSFER_PAUSED","TRANSFER_RESUMED","FILE_OPERATION_FAILED","FOLDER_SYNC_REQUESTED","AI_DOCUMENT_CREATED","FILE_DOWNLOADED","FILES_DOWNLOADED","FAVORITE_ADDED","FAVORITE_REMOVED","FILES_HIDDEN","FILES_UNHIDDEN","LABELS_ASSIGNED","LABELS_UNASSIGNED","LABEL_CREATED","LABEL_EDITED","LABEL_RENAMED","LABEL_DELETED","LABELS_MERGED","LABEL_GROUP_CREATED","LABEL_GROUP_EDITED","LABEL_GROUP_RENAMED","LABEL_GROUP_DELETED","BUCKET_GROUP_CREATED","BUCKET_GROUP_EDITED","BUCKET_GROUP_RENAMED","BUCKET_GROUP_DELETED","BUCKET_MOVED_TO_GROUP","PROJECT_CREATED","PROJECT_RENAMED","PROJECT_EDITED","PROJECT_ARCHIVED","PROJECT_UNARCHIVED","PROJECT_DELETED","PROJECT_ITEMS_ADDED","PROJECT_ITEMS_REMOVED","TRASH_SENT","TRASH_RESTORED","TRASH_DELETED","TRASH_PURGED","SHARE_CREATED","SHARE_EDITED","SHARE_REVOKED","SHARE_EXPIRED","SHARE_FIRST_VISIT","SHARE_DOWNLOAD_CLAIMED","SHARE_ZK_CONVERTED","INVITE_CREATED","INVITE_EDITED","INVITE_REVOKED","INVITE_ACCEPTED","INVITE_EXPIRED","INVITE_FIRST_ACCESS","INVITE_RECEIVED","INVITE_DOWNLOAD","INVITE_LEFT","SHARE_APPROVAL_REQUESTED","SHARE_APPROVAL_APPROVED","SHARE_APPROVAL_REJECTED","SHARE_APPROVAL_EXPIRED","SHARE_APPROVAL_CANCELLED","FILE_REQUEST_CREATED","FILE_REQUEST_EDITED","FILE_REQUEST_DELETED","FILE_REQUEST_EXPIRED","FILE_REQUEST_FIRST_VISIT","FILE_REQUEST_VISITOR_REGISTERED","FILE_REQUEST_RECEIVED","FILE_REQUEST_ZK_ADOPTED","FILE_REQUEST_ZK_CONVERTED","GALLERY_CREATED","GALLERY_EDITED","GALLERY_DELETED","GALLERY_EXPIRED","GALLERY_FIRST_VISIT","GALLERY_VISITOR_REGISTERED","GALLERY_PHOTO_LIKED","GALLERY_DOWNLOAD_CLAIMED","GALLERY_ZIP_DOWNLOADED","GALLERY_ZK_CONVERTED","GALLERY_COMMENTED","GALLERY_CLIENT_INVITED","GALLERY_DELIVERY_SENT","GALLERY_CURATED","GALLERY_INDEXED","AUTOMATION_RULE_CREATED","AUTOMATION_RULE_EDITED","AUTOMATION_RULE_DELETED","AUTOMATION_RULE_PAUSED","AUTOMATION_RULE_RESUMED","AUTOMATION_EXECUTED","RULE_REASSIGNED","RULE_PAUSED_CREATOR_REMOVED","EMBED_CREATED","EMBED_EDITED","EMBED_DUPLICATED","EMBED_PAUSED","EMBED_RESUMED","EMBED_TOKEN_ROTATED","EMBED_DELETED","EMBED_FIRST_VISIT","EMBED_EXPIRED","EMBED_FILE_UPLOADED","EMBED_FOLDER_CREATED","EMBED_FILE_DELETED","EMBEDS_PLAN_PAUSED","EMBEDS_PLAN_RESUMED"]}}},{"name":"x-nubbo-flow","required":false,"in":"header","description":"An id for the flow polling, when several flows share one key and the same filter, so each keeps its own pace and count. Up to 20 combinations of flow and filter per key and trigger polled in the last 24 hours (API_TRIGGER_FLOWS_LIMIT); a flow not polled for 30 days starts again as new.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTriggerPageResponseDto"}}}},"400":{"description":"API_CURSOR_INVALID, API_TRIGGER_FLOWS_LIMIT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_CURSOR_INVALID":{"summary":"This cursor does not belong to this request; start again without a cursor","value":{"statusCode":400,"message":"This cursor does not belong to this request; start again without a cursor","error":"Bad Request","code":"API_CURSOR_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_TRIGGER_FLOWS_LIMIT":{"summary":"This key polled this trigger with 20 combinations of flow and filter in the last 24 hours; reuse one of them","value":{"statusCode":400,"message":"This key polled this trigger with 20 combinations of flow and filter in the last 24 hours; reuse one of them","error":"Bad Request","code":"API_TRIGGER_FLOWS_LIMIT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"401":{"description":"API_KEY_REQUIRED, API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_KEY_REQUIRED":{"summary":"Send an API key as Authorization: Bearer nbk_…","value":{"statusCode":401,"message":"Send an API key as Authorization: Bearer nbk_…","error":"Unauthorized","code":"API_KEY_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_INVALID":{"summary":"This API key is not valid","value":{"statusCode":401,"message":"This API key is not valid","error":"Unauthorized","code":"API_KEY_INVALID","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_REVOKED":{"summary":"This API key was revoked","value":{"statusCode":401,"message":"This API key was revoked","error":"Unauthorized","code":"API_KEY_REVOKED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_EXPIRED":{"summary":"This API key has expired; rotate it in Nubbo to keep using it","value":{"statusCode":401,"message":"This API key has expired; rotate it in Nubbo to keep using it","error":"Unauthorized","code":"API_KEY_EXPIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"403":{"description":"API_PLAN_REQUIRED, API_KEY_MCP_ONLY, WORKSPACE_SUSPENDED, ACCOUNT_SUSPENDED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_PLAN_REQUIRED":{"summary":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","value":{"statusCode":403,"message":"The plan of this space does not include the Nubbo API; it comes with Pro and Teams","error":"Forbidden","code":"API_PLAN_REQUIRED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_MCP_ONLY":{"summary":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","value":{"statusCode":403,"message":"This API key belongs to an app connected to the Nubbo MCP server and works only there; create a key in the API tab to call the API","error":"Forbidden","code":"API_KEY_MCP_ONLY","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"WORKSPACE_SUSPENDED":{"summary":"This workspace is suspended","value":{"statusCode":403,"message":"This workspace is suspended","error":"Forbidden","code":"WORKSPACE_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"ACCOUNT_SUSPENDED":{"summary":"This account has been suspended","value":{"statusCode":403,"message":"This account has been suspended","error":"Forbidden","code":"ACCOUNT_SUSPENDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"410":{"description":"ACCOUNT_SCHEDULED_FOR_DELETION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"ACCOUNT_SCHEDULED_FOR_DELETION":{"summary":"Account is scheduled for deletion","value":{"statusCode":410,"message":"Account is scheduled for deletion","error":"Gone","code":"ACCOUNT_SCHEDULED_FOR_DELETION","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"429":{"description":"API_RATE_LIMITED, API_QUOTA_EXCEEDED, API_KEY_FAILURES, API_TRIGGER_TOO_FREQUENT","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"API_RATE_LIMITED":{"summary":"Too many requests for this API key; wait for the time in Retry-After","value":{"statusCode":429,"message":"Too many requests for this API key; wait for the time in Retry-After","error":"Too Many Requests","code":"API_RATE_LIMITED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_QUOTA_EXCEEDED":{"summary":"This space has reached a monthly API limit; see details.kind and details.resetsAt","value":{"statusCode":429,"message":"This space has reached a monthly API limit; see details.kind and details.resetsAt","error":"Too Many Requests","code":"API_QUOTA_EXCEEDED","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_KEY_FAILURES":{"summary":"Too many requests without a valid API key from this address; try again in a minute","value":{"statusCode":429,"message":"Too many requests without a valid API key from this address; try again in a minute","error":"Too Many Requests","code":"API_KEY_FAILURES","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}},"API_TRIGGER_TOO_FREQUENT":{"summary":"Poll this trigger at most once a minute; wait for the time in Retry-After","value":{"statusCode":429,"message":"Poll this trigger at most once a minute; wait for the time in Retry-After","error":"Too Many Requests","code":"API_TRIGGER_TOO_FREQUENT","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}},"503":{"description":"SHARED_STATE_UNAVAILABLE","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"examples":{"SHARED_STATE_UNAVAILABLE":{"summary":"Shared state is temporarily unavailable","value":{"statusCode":503,"message":"Shared state is temporarily unavailable","error":"Service Unavailable","code":"SHARED_STATE_UNAVAILABLE","timestamp":"2026-01-01T12:00:00.000Z","path":"/v1/…","requestId":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}}}}}}},"security":[{"apiKey":[]}],"summary":"New activity","tags":["Triggers"]}}},"info":{"title":"Nubbo API","description":"Work with everything in your Nubbo workspace, personal or team, from your own code, from AI assistants through the Nubbo MCP server, or from n8n, Zapier and Make. Triggers let your workflows react as soon as something changes.\n\n## Authentication\nCreate a key in **Settings › API** (Pro) or **Team › API** (owners and admins of a team). Send it on every call as `Authorization: Bearer nbk_…`. A key belongs to one space, reaches the whole space or chosen buckets and projects, and reads only or reads and writes. Keys never work in the Nubbo app, and app sessions never work here.\n\n## Limits\n- **Rate**: calls a minute per key (Pro 60, Teams 120). The `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` headers carry it; a refusal is `429 API_RATE_LIMITED` with `Retry-After`.\n- **Monthly quota**: requests and trigger events per space, reset with the billing period. `X-Nubbo-Quota-Requests-Remaining`, `X-Nubbo-Quota-Events-Remaining` and `X-Nubbo-Quota-Reset` carry it; a refusal is `429 API_QUOTA_EXCEEDED` with `details.kind` (`requests` or `events`) and the reset date in `details.resetsAt`. `GET /v1/me` and trigger polls do not count as requests, nor do answers 401, 429 or 5xx.\n- **Invalid keys**: calls without a valid key are limited per IP address; past the limit they answer `429 API_KEY_FAILURES` for a minute. Calls with a valid key don't count toward this limit.\n\n## Pagination\nLists take `limit` (1 to 100, default 50) and an opaque `cursor`, and answer `{ data, nextCursor }`. `nextCursor` is `null` on the last page.\n\n## Idempotency\nSend `Idempotency-Key` (1 to 255 visible ASCII characters) on a POST or PATCH to make a retry safe for 24 hours. A repeat with the same body replays the first answer with `Idempotent-Replayed: true`; a repeat while the first runs answers `409 API_IDEMPOTENCY_IN_PROGRESS`; another body answers `422 API_IDEMPOTENCY_MISMATCH`. Failed calls are not stored, so they run again. Presigned URLs are never stored: a replay of an upload start signs a fresh URL, and part URLs are signed again on every call. POST routes that only read, such as `download-link`, accept the header and ignore it: each call signs a new link and nothing is stored.\n\n## Uploads\nFiles travel straight between you and the storage provider; Nubbo never receives their content. Start with `POST /v1/buckets/{bucketId}/uploads`, send the bytes to the presigned URL (or to each part URL for multipart uploads), then call `POST /v1/uploads/{uploadId}/complete`. Missing parent folders are created for you.\n\n## Background work\nMoves of folders, large selections, moves to another bucket and some folder renames run in the background: they answer `202` with an `operationId` to follow with `GET /v1/operations/{operationId}`. The work runs as the key that started it, and stops with `API_KEY_REVOKED` when the key is revoked, expires, is blocked, loses write access or reach, or its team is suspended or read-only, checked before the work starts and at least once a minute while it runs.\n\n## Errors\nEvery error has `statusCode`, `message`, `error`, `code`, `timestamp`, `path`, `requestId` and, when it applies, `details`. The `code` is the contract: each operation lists the codes it can answer. Send `X-Request-Id` from the response header when you contact support.\n\n## Encrypted content\nNubbo cannot read what is encrypted end to end, and neither can a key. Encrypted buckets, folders, files, links, inboxes and galleries are listed with an opaque shape (`encrypted: true`, no name, path, size or type), refuse every change with `409 API_ENCRYPTED_CONTENT`, and never fire a trigger. Nothing can be created or moved into an encrypted folder: those calls answer `409 API_ENCRYPTED_DESTINATION`.\n\n## MCP\nAI assistants and tools that speak the Model Context Protocol and can send a header to a remote server (such as Claude Code or Cursor) connect to `https://api.nubbo.app/mcp` (Streamable HTTP, protocol 2025-11-25) with the same key, sent as `Authorization: Bearer nbk_…`. Each tool runs one or more of the calls in this reference under the key, so its space, reach, access, rate limit, quota and activity are the same. Tools: `whoami`, `list_buckets`, `list_folder`, `search_files`, `get_file`, `read_file`, `get_download_link`, `list_trash`, `list_labels`, `list_links`, `list_inboxes`, `list_inbox_uploads`, `list_galleries`, `list_projects`, `get_project`, `recent_activity`, `get_operation`, `create_folder`, `rename_file`, `move_files`, `trash_files`, `restore_files`, `set_file_label`, `create_link`, `update_link`, `create_inbox`, `update_inbox`, `create_upload_link`, `complete_upload` and `upload_file`. Results carry an `appUrl` that opens the item in Nubbo. Two tools pass content through Nubbo on the fly and keep nothing: `read_file` reads text files, PDF and Word documents as text and gives a small preview of photos (up to two requests), and `upload_file` saves up to 5 MB written in the chat (up to two requests). Encrypted content is never read. Errors come back as tool errors; those from the API carry their `code` of this reference.\n\nAssistants that connect by signing in instead of a header (such as Claude and ChatGPT connectors) use OAuth 2.1: the server publishes `/.well-known/oauth-protected-resource/mcp` and `/.well-known/oauth-authorization-server`, takes client ID metadata documents or dynamic registration, public clients with PKCE `S256` and returns `iss` on every authorization response. The person signs in to Nubbo, picks the space, read or write and the buckets or projects, and approves (in a team, only people who manage API keys can). Nubbo then creates an API key for that app, shown in the API tab as connected with it and revocable there; the access token is that key, valid for one hour (`expires_in`), and the refresh token renews its secret; a connection whose refresh token goes unused for 90 days ends by itself. Such a key works only through `/mcp`: calls to this API with it answer `403 API_KEY_MCP_ONLY`.\n\n## Versioning\nThe version is in the path. Fields, operations, optional parameters and error codes are added without notice, so ignore what you do not know. A breaking change ships as `/v2`, with `/v1` kept for at least 12 months and announced with `Deprecation` and `Sunset` headers and by email.\n\n## Changelog\n- **1** First version.","version":"1","contact":{}},"tags":[],"servers":[{"url":"https://api.nubbo.app"}],"components":{"securitySchemes":{"apiKey":{"scheme":"bearer","bearerFormat":"nbk_…","type":"http","description":"An API key from Settings › API or Team › API, sent as `Authorization: Bearer nbk_…`."}},"schemas":{"ErrorResponseDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Human-readable message; validation failures list one message per field."},"error":{"type":"string"},"code":{"type":"string","description":"Stable code the client translates: a specific code, or the HTTP status name (NOT_FOUND, TOO_MANY_REQUESTS…) when the error has none.","enum":["ACCEPTED","ACCESS_DENIED","ACCESS_FOLDER_NOT_FOUND","ACCESS_FOLDER_REDUNDANT","ACCESS_INVALID_CURSOR","ACCESS_PREFIX_LIMIT","ACCESS_ROLE_HAS_ALL","ACCESS_TARGET_REQUIRED","ACCESS_VIEWER_ONLY_VIEW","ACCOUNT_OWNS_TEAM","ACCOUNT_PAYS_TEAM","ACCOUNT_SCHEDULED_FOR_DELETION","ACCOUNT_SUSPENDED","ACTIVITY_BUCKET_NOT_FOUND","ACTIVITY_ELEMENT_FILTER_INVALID","ACTIVITY_PLAN_REQUIRED","ACTIVITY_PROJECT_NOT_FOUND","ADMIN_API_KEY_ALREADY_REVOKED","ADMIN_API_KEY_SCOPE_BOTH","ADMIN_API_KEY_SELF","ADMIN_STATS_RANGE_INVALID","ADMIN_STATS_RANGE_TOO_LONG","ADMIN_SUPPRESSION_NOT_FOUND","ADMIN_SUPPRESSION_RESEND_UNAVAILABLE","ADMIN_TEAMS_INVALID_CURSOR","ADMIN_TEAM_DOMAIN_NOT_FOUND","ADMIN_TEAM_NOT_FOUND","ADMIN_TEAM_SELF","ADMIN_TEMPLATE_NOT_FOUND","ADMIN_USER_ALREADY_DELETED","ADMIN_USER_ALREADY_SUSPENDED","ADMIN_USER_ALREADY_VERIFIED","ADMIN_USER_CANNOT_DEMOTE_ADMIN_ENV","ADMIN_USER_CANNOT_DEMOTE_SELF","ADMIN_USER_CANNOT_TERMINATE_ADMIN_ENV","ADMIN_USER_CANNOT_TERMINATE_SELF","ADMIN_USER_INVALID_ROLE","ADMIN_USER_NOT_SUSPENDED","AI_ADVANCED_PLAN_REQUIRED","AI_CONVERSATION_NOT_FOUND","AI_CONVERSATION_OUTCOME_INVALID","AI_CONVERSATION_PROPOSAL_NOT_FOUND","AI_CONVERSATION_PROPOSAL_NOT_PENDING","AI_CONVERSATION_PROPOSAL_RESOLVED","AI_CONVERSATION_PROPOSAL_STALE","AI_COST_CHANGED","AI_CREDITS_EXHAUSTED","AI_CREDITS_INSUFFICIENT","AI_DOCUMENTS_PLAN_REQUIRED","AI_DOCUMENT_ANALYZE_TAKES_NO_TASK","AI_DOCUMENT_IN_PROGRESS","AI_DOCUMENT_NOT_FOUND","AI_DOCUMENT_OUTPUT_ENCRYPTED","AI_DOCUMENT_OUTPUT_FOLDER_INVALID","AI_DOCUMENT_TEMPLATE_LIMIT","AI_DOCUMENT_TEMPLATE_NOT_FOUND","AI_INDEX_IN_PROGRESS","AI_LAST_MESSAGE_NOT_USER","AI_MEMBER_LIMIT_REACHED","AI_MODEL_NOT_AVAILABLE","AI_MODEL_SMOKE_FAILED","AI_MODEL_UNRESOLVED","AI_NOT_CONFIGURED","AI_NOT_ENTITLED","AI_NO_ELIGIBLE_FILES","AI_NO_INPUT","AI_OPT_IN_REQUIRED","AI_PROVIDER_FAILED","AI_STUDIO_PLAN_REQUIRED","AI_THROTTLED","AI_UNKNOWN_OPERATION","AI_UNKNOWN_TIER","AI_ZK_NOT_SUPPORTED","ALREADY_REPORTED","AMBIGUOUS","ANALYTICS_RANGE_TOO_LONG","ANALYTICS_USER_NOT_FOUND","API_COVER_OUTSIDE_GALLERY","API_CROSS_BUCKET_NEEDS_BROWSER","API_CURSOR_INVALID","API_ENCRYPTED_CONTENT","API_ENCRYPTED_DESTINATION","API_FILE_NOT_FOUND","API_FOLDER_NOT_DOWNLOADABLE","API_FOLDER_NOT_FOUND","API_IDEMPOTENCY_IN_PROGRESS","API_IDEMPOTENCY_KEY_INVALID","API_IDEMPOTENCY_MISMATCH","API_KEYS_BUCKET_NOT_FOUND","API_KEYS_CONNECTED_NOT_ROTATABLE","API_KEYS_ENDED","API_KEYS_EXPIRED_NOT_EDITABLE","API_KEYS_LIMIT_REACHED","API_KEYS_NOT_AVAILABLE","API_KEYS_NOT_FOUND","API_KEYS_PLAN_REQUIRED","API_KEYS_PROJECT_NOT_FOUND","API_KEYS_REACH_REQUIRED","API_KEYS_REACH_WITH_ALL","API_KEYS_REAUTH_REQUIRED","API_KEY_EXPIRED","API_KEY_FAILURES","API_KEY_INVALID","API_KEY_MCP_ONLY","API_KEY_NOT_ALLOWED","API_KEY_READ_ONLY","API_KEY_REQUIRED","API_KEY_REVOKED","API_KEY_WHOLE_SPACE_REQUIRED","API_MOVE_INTO_ITSELF","API_MOVE_ONE_BUCKET","API_NAME_TAKEN","API_OPERATION_FAILED","API_OPERATION_NOT_FOUND","API_PATH_TOO_DEEP","API_PLAN_REQUIRED","API_PROVIDER_FAILED","API_QUOTA_EXCEEDED","API_RATE_LIMITED","API_TRIGGER_FLOWS_LIMIT","API_TRIGGER_TOO_FREQUENT","API_UPLOAD_MULTIPART_TOO_SMALL","API_UPLOAD_NOT_FOUND","API_UPLOAD_NOT_MULTIPART","API_UPLOAD_NOT_RECEIVED","API_UPLOAD_PARTS_MISSING","API_UPLOAD_PART_OUT_OF_RANGE","API_UPLOAD_SIZE_MISMATCH","AUTH_EMAIL_ALREADY_VERIFIED","AUTH_EMAIL_NOT_VERIFIED","AUTH_INVALID_CREDENTIALS","AUTH_INVALID_EMAIL_OR_PASSWORD","AUTH_RECOVERY_CODES_NONE","AUTH_RECOVERY_CODE_INVALID","AUTH_REFRESH_TOKEN_EXPIRED","AUTH_REFRESH_TOKEN_INVALID","AUTH_REFRESH_TOKEN_NOT_PROVIDED","AUTH_RESET_TOKEN_EXPIRED","AUTH_RESET_TOKEN_INVALID","AUTH_RESET_VAULT_GRANT_INVALID","AUTH_TEMP_TOKEN_INVALID","AUTH_TEMP_TOKEN_WRONG_TYPE","AUTH_TOKEN_INVALID","AUTH_TWO_FACTOR_ALREADY_ENABLED","AUTH_TWO_FACTOR_CODE_REQUIRED","AUTH_TWO_FACTOR_INVALID_CODE","AUTH_TWO_FACTOR_NOT_CONFIGURED","AUTH_TWO_FACTOR_NOT_ENABLED","AUTH_TWO_FACTOR_NOT_INITIATED","AUTH_UNVERIFIED_EMAIL_CHANGE_LIMIT","AUTH_VERIFICATION_TOKEN_EXPIRED","AUTH_VERIFICATION_TOKEN_INVALID","AUTOMATION_AI_OPT_IN_REQUIRED","AUTOMATION_ASSIGNEES_INVALID_CURSOR","AUTOMATION_COMPRESS_DESTINATION_IS_SOURCE","AUTOMATION_COPY_NOT_SERVER_COMPATIBLE","AUTOMATION_CREATOR_REMOVED","AUTOMATION_DESTINATION_ENCRYPTED","AUTOMATION_INBOX_REQUIRED","AUTOMATION_INVALID_ACTION_CONFIG","AUTOMATION_INVALID_TRIGGER_CONFIG","AUTOMATION_NOT_ENTITLED","AUTOMATION_RULE_LIMIT_REACHED","AUTOMATION_RULE_NOT_FOUND","AUTOMATION_SOURCE_ENCRYPTED","AUTOMATION_ZK_PAUSED","AVATAR_INVALID_IMAGE","AVATAR_NOT_FOUND","AVATAR_TOO_LARGE","BAD_GATEWAY","BAD_REQUEST","BILLING_ADDON_ALREADY_CANCELLED","BILLING_ADDON_API_PACK_LIMIT","BILLING_ADDON_CHARGE_PENDING","BILLING_ADDON_GRANT_INVALID","BILLING_ADDON_NOT_AVAILABLE","BILLING_ADDON_NOT_CANCELLED","BILLING_ADDON_NOT_FOUND","BILLING_ADDON_REVOKE_GRANT_ONLY","BILLING_ADDON_WITHDRAWAL_NOT_AVAILABLE","BILLING_ALREADY_CANCEL_SCHEDULED","BILLING_ALREADY_ON_PLAN","BILLING_ANNUAL_SWITCH_COOLDOWN","BILLING_BLOCKED_RECORD_EMAIL_INVALID","BILLING_BUCKET_DISABLED","BILLING_BUCKET_LIMIT_REACHED","BILLING_BUNDLE_PRICE_NOT_IN_CENTS","BILLING_CHANGE_BLOCKED_WHILE_CANCELLING","BILLING_CHANGE_BLOCKED_WHILE_DISCOUNTED","BILLING_CHANGE_BLOCKED_WHILE_PAST_DUE","BILLING_CHANGE_BLOCKED_WHILE_PAUSED","BILLING_CHANGE_PENDING","BILLING_COMPENSATION_ALREADY_PENDING","BILLING_COMPENSATION_AMOUNT_TOO_HIGH","BILLING_COMPENSATION_LOOKUP_FAILED","BILLING_COMPENSATION_NOT_AVAILABLE","BILLING_COMPENSATION_NOT_FOUND","BILLING_COMPENSATION_NOT_PENDING","BILLING_CONCURRENT_CHANGE","BILLING_CONSENT_REQUIRED","BILLING_CREEM_CHANGE_IN_PROGRESS","BILLING_CREEM_REQUEST_FAILED","BILLING_CREEM_REQUEST_REJECTED","BILLING_EVENT_ALREADY_PROCESSED","BILLING_EVENT_NOT_FOUND","BILLING_EVENT_PAYLOAD_DISCARDED","BILLING_FILE_REQUEST_LIMIT_REACHED","BILLING_GALLERY_LIMIT_REACHED","BILLING_INVALID_DOWNGRADE_SELECTION","BILLING_INVITE_ITEM_LIMIT_REACHED","BILLING_INVITE_LIMIT_REACHED","BILLING_LOCKED_BY_YEARLY_SWITCH","BILLING_NOT_CONFIGURED","BILLING_OVERRIDE_END_NOT_IN_FUTURE","BILLING_OVERRIDE_REMOTE_CANCEL_FAILED","BILLING_PENDING_REFUNDS_CURSOR_INVALID","BILLING_PENDING_REFUND_DISPUTED","BILLING_PENDING_REFUND_NOT_FOUND","BILLING_PRICE_CAMPAIGN_INVALID","BILLING_PRICE_CAMPAIGN_NOT_DRAFT","BILLING_PRICE_CAMPAIGN_NOT_FOUND","BILLING_PRICE_CAMPAIGN_NOT_LAUNCHED","BILLING_PRICE_CAMPAIGN_OVERLAP","BILLING_PRICE_CAMPAIGN_REASON_INCOMPLETE","BILLING_PRICE_CAMPAIGN_TEAMS_NOT_SUPPORTED","BILLING_PRICE_CAMPAIGN_TERMS_NOTICE_FAILING","BILLING_PRICE_CAMPAIGN_TERMS_NOTICE_PENDING","BILLING_PRICE_CAMPAIGN_TERMS_NOTICE_REQUIRED","BILLING_PRICE_CHANGE_END_REQUESTED","BILLING_PRICE_CHANGE_END_WINDOW_CLOSED","BILLING_PRICE_CHANGE_NOT_FOUND","BILLING_PURCHASES_BLOCKED","BILLING_REFERRAL_DISCOUNT_UNAVAILABLE","BILLING_REFUND_ALREADY_REQUESTED","BILLING_REFUND_FAILED","BILLING_REFUND_NOT_AVAILABLE","BILLING_RESOURCE_DISABLED","BILLING_RESUME_NOT_ALLOWED","BILLING_SELECTION_ALREADY_MADE","BILLING_SELECTION_WINDOW_CLOSED","BILLING_SUBSCRIPTION_EXISTS","BILLING_SUBSCRIPTION_NOT_CANCEL_SCHEDULED","BILLING_SUBSCRIPTION_NOT_FOUND","BILLING_SWITCH_BACK_PENDING","BILLING_TERMINATE_REMOTE_CANCEL_FAILED","BILLING_UNKNOWN_PLAN_PRODUCT","BILLING_WEBHOOK_MODE_MISMATCH","BILLING_WITHDRAWAL_ALREADY_REQUESTED","BILLING_WITHDRAWAL_IN_PROGRESS","BILLING_WITHDRAWAL_NOT_AVAILABLE","BILLING_WITHDRAWAL_RECEIVED_BEFORE_CONTRACT","BILLING_WITHDRAWAL_WINDOW_CLOSED","BROADCAST_AUDIENCE_LANGUAGE_MISSING","BROADCAST_CANNOT_CANCEL","BROADCAST_CANNOT_DELETE_IN_FLIGHT","BROADCAST_CONTENT_INCOMPLETE","BROADCAST_NOT_EDITABLE","BROADCAST_NOT_FOUND","BROADCAST_NO_CHANNEL","BROADCAST_NO_CONTENT","BROADCAST_NO_CONTENT_DISPATCH","BROADCAST_ONLY_DRAFT_CAN_SEND","BROADCAST_SUBJECT_TOO_LONG","BROADCAST_TRANSLATE_SOURCE_INCOMPLETE","BUCKET_ACCESS_DENIED","BUCKET_ACCESS_INSUFFICIENT","BUCKET_CONNECT_FAILED","BUCKET_CORS_FORBIDDEN","BUCKET_CORS_NOT_APPLIED","BUCKET_CORS_RULE_LIMIT","BUCKET_CORS_UNSUPPORTED","BUCKET_DEEP_SYNC_FAILED","BUCKET_DELETE_FAILED","BUCKET_GROUP_DECRYPT_NAME_EXISTS","BUCKET_GROUP_NAME_EXISTS","BUCKET_GROUP_NOT_AUTHORIZED","BUCKET_GROUP_NOT_FOUND","BUCKET_INVALID_REGION","BUCKET_IN_USE","BUCKET_KEYS_NOT_WAITING","BUCKET_MOVE_BUSY","BUCKET_MOVE_CASCADES_PENDING","BUCKET_MOVE_ENCRYPTED_OWNER_ONLY","BUCKET_MOVE_ENCRYPTED_PLAN","BUCKET_MOVE_FORBIDDEN","BUCKET_MOVE_GALLERY_MEDIA_HOSTED","BUCKET_MOVE_GALLERY_MEDIA_PREVIOUS","BUCKET_MOVE_GALLERY_OWNER_KEY","BUCKET_MOVE_GALLERY_PHOTO_IDS_PENDING","BUCKET_MOVE_INBOX_ARRIVALS","BUCKET_MOVE_INBOX_CHECKING","BUCKET_MOVE_IN_PROGRESS","BUCKET_MOVE_KEYS_PENDING","BUCKET_MOVE_KEY_WORK","BUCKET_MOVE_LABELS_CHANGED","BUCKET_MOVE_LEGACY_LINK_COPIES","BUCKET_MOVE_LOOSE_FILES","BUCKET_MOVE_NOT_CONFIRMED","BUCKET_MOVE_RECIPIENT_ONLY_RESOURCES","BUCKET_MOVE_RESERVED_FOLDER","BUCKET_MOVE_RESOURCES_OUTSIDE_AREA","BUCKET_MOVE_RESOURCE_KEY_WORK","BUCKET_MOVE_STAGING_AREAS","BUCKET_MOVE_STAGING_DELTA","BUCKET_MOVE_STAGING_GALLERY_ITEMS_INVALID","BUCKET_MOVE_STAGING_INVALID","BUCKET_MOVE_STAGING_MOVER_ONLY","BUCKET_MOVE_STAGING_NOT_FOUND","BUCKET_MOVE_STAGING_PLAIN","BUCKET_MOVE_STAGING_REQUIRED","BUCKET_MOVE_STAGING_RESOURCES_INVALID","BUCKET_MOVE_STAGING_ROOTS","BUCKET_MOVE_TEAM_ENCRYPTION_OFF","BUCKET_MOVE_TEAM_KEYS_LEFT","BUCKET_MOVE_UNREADABLE_FILES","BUCKET_MOVE_UNREADABLE_RESOURCES","BUCKET_MOVE_VAULT_REQUIRED","BUCKET_NAME_INVALID","BUCKET_NOT_FOUND","BUCKET_REMOVAL_RUNNING","BUCKET_REMOVE_MOVE_KEYS","BUCKET_REORDER_MISMATCH","BUCKET_S3_ACCESS_DENIED","BUCKET_S3_BUCKET_NOT_FOUND","BUCKET_S3_CONNECTION_FAILED","BUCKET_S3_CONNECTION_TIMEOUT","BUCKET_S3_ENDPOINT_UNREACHABLE","BUCKET_S3_INVALID_CREDENTIALS","BUCKET_S3_INVALID_ENDPOINT","BUCKET_S3_PRIVATE_ENDPOINT","BUCKET_S3_REGION_MISMATCH","BUCKET_TEST_FAILED","BUCKET_TRANSFER_DESTINATION_DELETED","BUCKET_USAGE_FAILED","BUCKET_ZK_ARRIVALS_PRESENT","BUCKET_ZK_FILES_PRESENT","CAPTCHA_EXPIRED","CAPTCHA_INCORRECT","CAPTCHA_INVALID","CLOSED_TEAM_KEYS_NOT_FOUND","CONFLICT","CONTACT_DELIVERY_FAILED","CONTENT_DIFFERENT","CONTINUE","CREATED","DATA_EXPORT_ALREADY_IN_PROGRESS","DATA_EXPORT_BUCKET_DELETED","DATA_EXPORT_BUCKET_INACTIVE","DATA_EXPORT_BUCKET_MISMATCH","DATA_EXPORT_BUCKET_NOT_PERSONAL","DATA_EXPORT_DESTINATION_ENCRYPTED","DATA_EXPORT_EXPORT_BUCKET_INACTIVE","DATA_EXPORT_INVALID_BUCKET_ID","DATA_EXPORT_JOB_NO_BUCKET","DATA_EXPORT_NO_BUCKET","DATA_EXPORT_TOO_LARGE","DATA_EXPORT_UPLOAD_FAILED","DATA_EXPORT_WORKER_TIMEOUT","DOMAIN_CHECK_UNAVAILABLE","DOMAIN_FREE_MAIL","DOMAIN_INVALID","DOMAIN_LIMIT","DOMAIN_NOT_FOUND","DOMAIN_NOT_VERIFIED","DOMAIN_RECORD_NOT_FOUND","DOMAIN_TAKEN","DOWNLOAD_RELEASE_NOT_ALLOWED","DUPLICATES_CURSOR_INVALID","DUPLICATES_NOT_ENTITLED","EARLY_HINTS","EMBED_CONFIG_INVALID","EMBED_CURSOR_INVALID","EMBED_DOMAIN_INVALID","EMBED_DOWNLOAD_TICKET_INVALID","EMBED_EVENTS_REJECTED","EMBED_EXPLORER_PATH_OUTSIDE","EMBED_FILE_NOT_FOUND","EMBED_LIMIT_REACHED","EMBED_NOT_ENTITLED","EMBED_NOT_FOUND","EMBED_PASSWORD_INVALID","EMBED_PASSWORD_REQUIRED","EMBED_PRESENTATION_INVALID","EMBED_PREVIEW_EXPIRED","EMBED_PREVIEW_READ_ONLY","EMBED_SOURCE_NOT_ELIGIBLE","EMBED_SOURCE_NOT_FOUND","EMBED_SOURCE_REQUIRED","EMBED_UNAVAILABLE","EMBED_UPLOAD_LIMIT_REACHED","EMBED_UPLOAD_TOO_LARGE","EMBED_WRITE_NOT_ALLOWED","EMBED_WRITE_TARGET_INVALID","EMBED_ZIP_UNAVAILABLE","ERROR","ERROR_GROUP_NOT_FOUND","ERROR_INVALID_CURSOR","ERROR_INVALID_STATUS","ERROR_RELEASE_INVALID","ERROR_SOURCEMAP_INVALID","ERROR_SOURCEMAP_TOKEN_INVALID","ERROR_SOURCEMAP_TOO_LARGE","EXPECTATION_FAILED","FAILED_DEPENDENCY","FILES_CANNOT_RESTORE_ACTIVE","FILES_CROSS_TRANSFER_CLOUD_NOT_SUPPORTED","FILES_CROSS_TRANSFER_HELD","FILES_CROSS_TRANSFER_ITEM_CLOSED","FILES_CROSS_TRANSFER_ITEM_NOT_FOUND","FILES_CROSS_TRANSFER_NOT_FOUND","FILES_CROSS_TRANSFER_NOT_SIGNED","FILES_CROSS_TRANSFER_NO_ITEMS","FILES_CROSS_TRANSFER_PAUSED","FILES_DEEP_SYNC_IN_PROGRESS","FILES_DEEP_SYNC_RATE_LIMITED","FILES_EDITOR_CONFLICT","FILES_EDITOR_ENCRYPTED_UNSUPPORTED","FILES_EDITOR_ETAG_MISSING","FILES_EDITOR_FILE_NOT_FOUND","FILES_EDITOR_FILE_TOO_LARGE","FILES_FOLDER_NAME_INVALID","FILES_LIST_CURSOR_INVALID","FILES_LIST_REVEAL_WITH_CURSOR","FILES_MANIFEST_CURSOR_INVALID","FILES_MOVE_INTO_OWN_DESCENDANT","FILES_MULTIPART_FILE_TOO_LARGE","FILES_RENAME_BUCKET_BUSY","FILES_RENAME_IN_PROGRESS","FILES_RENAME_LIMIT_REACHED","FILES_RENAME_PASS_ACTIVE","FILES_RENAME_SOURCE_MISSING","FILES_RESERVED_FOLDER_NAME","FILES_REVEAL_NOT_IN_FOLDER","FILES_SEARCH_CRITERIA_REQUIRED","FILES_SEARCH_DATE_RANGE_INVALID","FILES_SEARCH_OFFSET_WITH_QUERY","FILES_SEARCH_PREFIX_REQUIRES_BUCKET","FILES_SEARCH_SIZE_RANGE_INVALID","FILES_SEARCH_TIMEOUT","FILES_SEARCH_ZK_TOKENS_MISMATCH","FILES_TRASH_NOTHING_TO_DELETE","FILES_UPLOAD_MOVED_REFUSED","FILES_UPLOAD_STRATEGY_UNSUPPORTED","FILES_ZK_DEPENDENTS_PRESENT","FILES_ZK_DOOR_DESTINATION_EXISTS","FILES_ZK_DOOR_FOLDER_HAS_ENCRYPTED","FILES_ZK_DOOR_INVALID","FILES_ZK_ENCRYPT_DOOR_REQUIRED","FILES_ZK_ENVELOPE_BACKED","FILES_ZK_FINALIZE_BUSY","FILES_ZK_GHOST_NOT_LEFTOVER","FILES_ZK_GHOST_TARGET_INVALID","FILES_ZK_LEASE_HELD","FILES_ZK_LEASE_INVALID","FILES_ZK_MAGIC_INVALID","FILES_ZK_OBJECT_ALREADY_SEALED","FILES_ZK_PASS_ACTIVE","FILES_ZK_PASS_ADOPT_INVALID","FILES_ZK_PASS_ITEM_NOT_FOUND","FILES_ZK_PASS_KEY_INVALID","FILES_ZK_PASS_NOT_FOUND","FILES_ZK_PASS_NO_FILES","FILES_ZK_PASS_NO_UNDO","FILES_ZK_PASS_PREFIX_INVALID","FILES_ZK_PASS_SCOPE_INVALID","FILES_ZK_PLAINTEXT_INTO_ENCRYPTED","FILES_ZK_RENAME_TARGET_EXISTS","FILES_ZK_ROLLBACK_INVALID","FILES_ZK_SCOPE_INSIDE_MARKED","FILES_ZK_SIZE_MISMATCH","FILES_ZK_STATE_MISMATCH","FILES_ZK_SWAP_VERIFY_FAILED","FILES_ZK_TARGET_NOT_FOUND","FILES_ZK_TMP_KEY_INVALID","FILES_ZK_TMP_MISSING","FILES_ZK_TRANSFER_MARKED_FOLDER","FILES_ZK_UNREADABLE","FILES_ZK_WRAP_REQUIRED","FILE_NOT_FOUND","FILE_REQUEST_CHANGED","FILE_REQUEST_DELETE_FAILED","FILE_REQUEST_EXCHANGE_PASSWORD_FIRST","FILE_REQUEST_EXPIRED","FILE_REQUEST_FILE_TOO_LARGE","FILE_REQUEST_FILE_TYPE_NOT_ALLOWED","FILE_REQUEST_IDENTITY_REQUIRED","FILE_REQUEST_INTEGRATION_NOT_AVAILABLE","FILE_REQUEST_INTEGRATION_NOT_ENABLED","FILE_REQUEST_INTEGRATION_USE_HEADER","FILE_REQUEST_INTEGRATION_ZK_NOT_SUPPORTED","FILE_REQUEST_MAX_UPLOADS","FILE_REQUEST_NOT_FOUND","FILE_REQUEST_NO_FREE_NAME","FILE_REQUEST_TOKEN_COLLISION","FILE_REQUEST_UPLOAD_KEY_LEADING_SLASH","FILE_REQUEST_UPLOAD_NOT_LANDED","FILE_REQUEST_UPLOAD_TOO_OLD","FILE_REQUEST_ZK_ALREADY_ENABLED","FILE_REQUEST_ZK_AREA_MISMATCH","FILE_REQUEST_ZK_DESTINATION_ENCRYPTED","FILE_REQUEST_ZK_ENVELOPE_NOT_ALLOWED","FILE_REQUEST_ZK_ENVELOPE_NOT_FOUND","FILE_REQUEST_ZK_ENVELOPE_REQUIRED","FILE_REQUEST_ZK_KEY_ROTATED","FILE_REQUEST_ZK_NOT_ENABLED","FILE_REQUEST_ZK_UPLOADS_PENDING","FORBIDDEN","FOUND","GALLERY_ACCESS_DENIED_FILE","GALLERY_ACCESS_DENIED_IMAGE","GALLERY_CLIENT_EXISTS","GALLERY_CLIENT_NOT_FOUND","GALLERY_COMMENTS_DISABLED","GALLERY_COMMENT_NOT_FOUND","GALLERY_COMMENT_RATE_LIMITED","GALLERY_COVER_VIDEO_INVALID","GALLERY_CREATE_FAILED","GALLERY_DELETE_FAILED","GALLERY_DELIVERY_LIMIT","GALLERY_DELIVERY_NO_RECIPIENTS","GALLERY_DELIVERY_OWNER_COMPOSED_UNAVAILABLE","GALLERY_DOWNLOADS_DISABLED","GALLERY_DOWNLOAD_TICKET_INVALID","GALLERY_DOWNLOAD_TOKEN_INVALID","GALLERY_EXCHANGE_PASSWORD_FIRST","GALLERY_EXPIRED","GALLERY_FAVOURITES_NOT_FOUND","GALLERY_FOLDER_NOT_FOUND","GALLERY_IMAGE_NOT_FOUND","GALLERY_ITEM_OUTSIDE_GALLERY","GALLERY_MEDIA_CURSOR_INVALID","GALLERY_MEDIA_PLAIN_ONLY","GALLERY_MEDIA_STAMP_INVALID","GALLERY_MEDIA_STAMP_STALE","GALLERY_MEDIA_UNAVAILABLE","GALLERY_MEDIA_VARIANT_UNAVAILABLE","GALLERY_NOT_FOUND","GALLERY_NOT_INDEXED","GALLERY_PIN_INVALID","GALLERY_PIN_LOCKED","GALLERY_PIN_REQUIRED","GALLERY_PLAIN_TARGET_ENCRYPTED","GALLERY_PREVIEW_TOKEN_INVALID","GALLERY_REORDER_MISMATCH","GALLERY_SEARCH_CURSOR_INVALID","GALLERY_SET_EXISTS","GALLERY_SET_NOT_FOUND","GALLERY_SET_OUTSIDE_GALLERY","GALLERY_SET_UNKNOWN","GALLERY_SIZE_NOT_ALLOWED","GALLERY_STUDIO_PLAN_REQUIRED","GALLERY_TOKEN_COLLISION","GALLERY_VISITOR_CURSOR_INVALID","GALLERY_VISITOR_NOT_REGISTERED","GALLERY_WATERMARK_FAILED","GALLERY_ZIP_DISABLED","GALLERY_ZK_ALREADY_ENABLED","GALLERY_ZK_COMMENT_SEALED_REQUIRED","GALLERY_ZK_DELIVERY_OWNER_COMPOSED","GALLERY_ZK_DERIVATIVE_COPY_UNCONFIRMED","GALLERY_ZK_DERIVATIVE_MISSING","GALLERY_ZK_DOWNLOAD_NOT_PREPARED","GALLERY_ZK_DOWNLOAD_VARIANTS_PLAINTEXT","GALLERY_ZK_ITEM_TEXT_SEALED_REQUIRED","GALLERY_ZK_LIKED_CLIENT_SIDE","GALLERY_ZK_LIKES_LIMIT","GALLERY_ZK_LIKE_OPAQUE_REQUIRED","GALLERY_ZK_MEDIA_CURSOR_INVALID","GALLERY_ZK_MEDIA_UNAVAILABLE","GALLERY_ZK_NOT_ENABLED","GALLERY_ZK_ORIGINALS_SEALED","GALLERY_ZK_OWNER_KEY_SET","GALLERY_ZK_PHOTO_IDS_NOT_MOVED","GALLERY_ZK_PREVIOUS_ELSEWHERE","GALLERY_ZK_RECORDS_SEALED","GALLERY_ZK_RECORD_OUTSIDE","GALLERY_ZK_RELOCATIONS_CHANGED","GALLERY_ZK_RELOCATIONS_CURSOR_INVALID","GALLERY_ZK_SET_NAMES_INCOMPLETE","GALLERY_ZK_SET_NAME_SEALED_REQUIRED","GALLERY_ZK_WALK_PLAIN","GALLERY_ZK_WATERMARK_CHANGE_INVALID","GALLERY_ZK_WATERMARK_PLAINTEXT","GATEWAY_TIMEOUT","GONE","HEALTH_DATABASE_UNAVAILABLE","HEALTH_WORKER_UNAVAILABLE","HTTP_VERSION_NOT_SUPPORTED","INSUFFICIENT_PERMISSIONS","INSUFFICIENT_STORAGE","INTERNAL_SERVER_ERROR","INVALID_PASSWORD","INVITE_CURSOR_INVALID","INVITE_DOWNLOAD_NOT_ALLOWED","INVITE_DOWNLOAD_TICKET_INVALID","INVITE_ENCRYPTED_NEEDS_KEYS","INVITE_ENCRYPTED_UNREADABLE","INVITE_EXPIRED","INVITE_FILE_NOT_FOUND","INVITE_ITEM_NOT_FOUND","INVITE_MAX_DOWNLOADS","INVITE_NOT_ENTITLED","INVITE_NOT_FOUND","INVITE_PATH_OUTSIDE","INVITE_RECIPIENT_IS_MEMBER","INVITE_RECIPIENT_NO_VAULT","INVITE_REVOKED","INVITE_ROOT_NOT_SHAREABLE","INVITE_SELF","INVITE_UNAVAILABLE","INVITE_ZIP_UNAVAILABLE","INVITE_ZK_COPY_INVALID","INVITE_ZK_NAME_TOKENS_STALE","INVITE_ZK_NOT_NEEDED","INVITE_ZK_RECIPIENTS_MISMATCH","I_AM_A_TEAPOT","JOIN_ALREADY_MEMBER","JOIN_DOMAIN_MISMATCH","JOIN_REQUEST_NOT_FOUND","JOIN_REQUEST_WAIT","LABEL_BULK_TARGET_REQUIRED","LABEL_CHANGED","LABEL_DECRYPT_NAME_EXISTS","LABEL_GROUP_DECRYPT_NAME_EXISTS","LABEL_GROUP_LIMIT","LABEL_GROUP_NAME_EXISTS","LABEL_GROUP_NOT_AUTHORIZED","LABEL_GROUP_NOT_FOUND","LABEL_INVALID_IDS","LABEL_MERGE_INVALID","LABEL_NAME_EXISTS","LABEL_NOT_AUTHORIZED","LABEL_NOT_FOUND","LABEL_ROUTED","LENGTH_REQUIRED","LIST_CURSOR_INVALID","LIST_WINDOW_WITH_SEARCH","LOCKED","LOOP_DETECTED","METHOD_NOT_ALLOWED","MISDIRECTED","MOVED_PERMANENTLY","MULTI_STATUS","NON_AUTHORITATIVE_INFORMATION","NOTIFICATION_NOT_FOUND","NOTIFICATION_UNKNOWN_TYPE","NOT_ACCEPTABLE","NOT_FOUND","NOT_IMPLEMENTED","NOT_MODIFIED","NO_CONTENT","OAUTH_REQUEST_NOT_FOUND","OK","OPERATION_CLAIM_LOST","OPERATION_PAYLOAD_INVALID","OPERATION_UNSUPPORTED_TYPE","PARTIAL_CONTENT","PASSWORD_LOCKED","PASSWORD_REQUIRED","PASSWORD_REVEAL_ALREADY_CONSUMED","PASSWORD_REVEAL_ALREADY_VIEWED","PASSWORD_REVEAL_EXPIRED","PASSWORD_REVEAL_NOT_FOUND","PASSWORD_REVEAL_NOT_YOUR_FILE_REQUEST","PASSWORD_REVEAL_NOT_YOUR_GALLERY","PASSWORD_REVEAL_NOT_YOUR_SHARE","PASSWORD_REVEAL_PASSWORD_CHANGED","PASSWORD_REVEAL_PASSWORD_REMOVED","PASSWORD_REVEAL_RATE_LIMIT_HOUR","PASSWORD_REVEAL_RATE_LIMIT_RECIPIENT","PASSWORD_REVEAL_RESOURCE_DELETED","PASSWORD_REVEAL_RESOURCE_NO_PASSWORD","PASSWORD_REVEAL_REVOKED","PASSWORD_REVEAL_WRONG_PASSWORD","PASSWORD_REVEAL_ZK_RESOURCE","PATH_NOT_FOUND","PAYLOAD_TOO_LARGE","PAYMENT_REQUIRED","PERMANENT_REDIRECT","PRECONDITION_FAILED","PRECONDITION_REQUIRED","PROCESSING","PROJECT_ACCESS_INSUFFICIENT","PROJECT_FOLDERS_LIMIT","PROJECT_INVALID_CURSOR","PROJECT_ITEM_NOT_FOUND","PROJECT_NAME_EXISTS","PROJECT_NOT_ENTITLED","PROJECT_NOT_FOUND","PROJECT_PHOTO_INVALID","PROJECT_PHOTO_NOT_FOUND","PROJECT_PHOTO_TOO_LARGE","PROJECT_SEARCH_TIMEOUT","PROVIDER_BUCKET_CREATE_FAILED","PROVIDER_BUCKET_CREATE_FORBIDDEN","PROVIDER_BUCKET_NAME_INVALID","PROVIDER_BUCKET_NAME_TAKEN","PROVIDER_BUCKET_REGION_INVALID","PROXY_AUTHENTICATION_REQUIRED","REQUESTED_RANGE_NOT_SATISFIABLE","REQUEST_TIMEOUT","RESET_CONTENT","RESOURCE_OWNER_DELETED","RESOURCE_OWNER_SUSPENDED","RESOURCE_TEAM_PAUSED","RULE_REASSIGN_NO_ACCESS","SAVED_SEARCH_NAME_EXISTS","SAVED_SEARCH_NOT_AUTHORIZED","SAVED_SEARCH_NOT_FOUND","SEE_OTHER","SERVICE_UNAVAILABLE","SESSION_REVOKED","SHARED_STATE_UNAVAILABLE","SHARE_ACCESS_DENIED_FILE","SHARE_ACCESS_DENIED_PATH","SHARE_APPROVAL_DECIDED","SHARE_APPROVAL_NEEDS_SHARING","SHARE_APPROVAL_NOT_FOUND","SHARE_APPROVAL_PENDING","SHARE_CREATE_FAILED","SHARE_DELETE_FAILED","SHARE_DIRECT_FOLDER_NOT_SUPPORTED","SHARE_DIRECT_ZK_NOT_SUPPORTED","SHARE_DOWNLOAD_TICKET_INVALID","SHARE_EXCHANGE_PASSWORD_FIRST","SHARE_EXPIRED","SHARE_INTEGRATION_NOT_AVAILABLE","SHARE_INTEGRATION_REQUIRED","SHARE_INTEGRATION_USE_HEADER","SHARE_MAX_DOWNLOADS","SHARE_NOT_FOLDER","SHARE_NOT_FOUND","SHARE_PLAIN_TARGET_ENCRYPTED","SHARE_SEALED_COPY_INVALID","SHARE_SEALED_COPY_IN_USE","SHARE_SOURCE_NOT_FOUND","SHARE_TOKEN_COLLISION","SHARE_ZK_ALREADY_ENABLED","SHARE_ZK_ENABLED","SHARE_ZK_FOLDER_DOWNGRADE_UNSUPPORTED","SHARE_ZK_NOT_ENABLED","SHARE_ZK_SOURCE_ENCRYPTED","SHARE_ZK_SOURCE_MISSING","SHARE_ZK_SOURCE_SEALED","SHARE_ZK_TARGET_INVALID","SLACK_ALREADY_CONNECTED","SLACK_BAD_SIGNATURE","SLACK_CHANNEL_LIMIT","SLACK_CHANNEL_NOTICE_APPROVALS","SLACK_CHANNEL_NOTICE_SCOPE","SLACK_CHANNEL_NOT_AVAILABLE","SLACK_CHANNEL_NOT_FOUND","SLACK_CHANNEL_PROJECT_ARCHIVED","SLACK_CHANNEL_PROJECT_REQUIRED","SLACK_CHANNEL_SCOPE_TARGET","SLACK_CHANNEL_TAKEN","SLACK_LINK_ALREADY","SLACK_LINK_EMAIL_MISMATCH","SLACK_LINK_EMAIL_MISSING","SLACK_LINK_EXPIRED","SLACK_LINK_NOT_FOUND","SLACK_LINK_NOT_MEMBER","SLACK_LINK_SLACK_ACCOUNT_INVALID","SLACK_LINK_TAKEN","SLACK_LINK_TEAM_MISMATCH","SLACK_NOT_CONFIGURED","SLACK_NOT_CONNECTED","SLACK_TEAM_DRAFT","SLACK_UNAVAILABLE","STATS_INVALID_RANGE","STATS_MEMBER_WITH_PROJECT","STATS_NOT_ENTITLED","STATS_NOT_FOUND","STATS_PROJECT_NOT_ENTITLED","STORAGE_EMPTY_RESPONSE_BODY","STORAGE_MISSING_CUSTOM_ENDPOINT","STORAGE_MISSING_ETAG","STORAGE_NO_BUCKET_ID","STORAGE_NO_UPLOAD_ID","STORAGE_PRIVATE_ADDRESS_REFUSED","STORAGE_UNSUPPORTED_PROVIDER","STORAGE_UNSUPPORTED_URL_PROTOCOL","SWITCHING_PROTOCOLS","TEAMS_SEATS_MINIMUM","TEAM_ALREADY_CLOSED","TEAM_ALREADY_SUSPENDED","TEAM_BILLING_ALREADY_ACTIVE","TEAM_BILLING_NOT_FOUND","TEAM_BILLING_NOT_PAYER","TEAM_BILLING_NOT_RENEWING","TEAM_CHARGE_SEATS_IN_USE","TEAM_CHARGE_WITHDRAWAL_NOT_AVAILABLE","TEAM_INVITE_ALREADY_MEMBER","TEAM_INVITE_ALREADY_PENDING","TEAM_INVITE_DRAFT_LIMIT","TEAM_INVITE_EMAIL_MISMATCH","TEAM_INVITE_EMAIL_NOT_CONFIRMED","TEAM_INVITE_EXPIRED","TEAM_INVITE_NOT_FOUND","TEAM_INVITE_REVOKED","TEAM_LOCKED_BY_YEARLY_SWITCH","TEAM_NOT_CLOSED","TEAM_NOT_SUSPENDED","TEAM_OVERRIDE_ENDS_BEFORE_PAID_PERIOD","TEAM_OVERRIDE_NOT_ALLOWED","TEAM_OVERRIDE_NOT_FOUND","TEAM_SUSPENDED_WITH_OWNER","TEAM_TAKEOVER_NOT_DUE","TEAM_ZK_ACTIVATION_INVALID","TEAM_ZK_ADOPT_DECRYPT_REFUSED","TEAM_ZK_ALREADY_ENABLED","TEAM_ZK_ANCHOR_KEY_MISSING","TEAM_ZK_APPROVAL_INVALID","TEAM_ZK_APPROVAL_ROSTER_STALE","TEAM_ZK_AREAS_LIMIT","TEAM_ZK_AREA_CLAIM_TEAM_ONLY","TEAM_ZK_AREA_FOLDER_MERGE_REFUSED","TEAM_ZK_AREA_FOLDER_MOVE_REFUSED","TEAM_ZK_AREA_KEY_MISSING","TEAM_ZK_AREA_MISMATCH","TEAM_ZK_AREA_MOVE_ACROSS_APPLYING","TEAM_ZK_AREA_MOVE_ACROSS_COPY_MISMATCH","TEAM_ZK_AREA_MOVE_ACROSS_DESTINATION_TAKEN","TEAM_ZK_AREA_MOVE_ACROSS_FAILED_ROWS","TEAM_ZK_AREA_MOVE_ACROSS_FOLDED","TEAM_ZK_AREA_MOVE_ACROSS_FROZEN","TEAM_ZK_AREA_MOVE_ACROSS_KEYS_DELIVER_REQUIRED","TEAM_ZK_AREA_MOVE_ACROSS_NOT_AREA_FOLDER","TEAM_ZK_AREA_MOVE_ACROSS_NOT_ARMED","TEAM_ZK_AREA_MOVE_ACROSS_NOT_FOUND","TEAM_ZK_AREA_MOVE_ACROSS_NOT_STAGED","TEAM_ZK_AREA_MOVE_ACROSS_PLAIN","TEAM_ZK_AREA_MOVE_ACROSS_ROOT","TEAM_ZK_AREA_MOVE_ACROSS_ROSTER_REQUIRED","TEAM_ZK_AREA_MOVE_ACROSS_ROW_CHANGED","TEAM_ZK_AREA_MOVE_ACROSS_SAME_BUCKET","TEAM_ZK_AREA_MOVE_ACROSS_SERVER_COPY","TEAM_ZK_AREA_MOVE_PREFLIGHT_TOO_LARGE","TEAM_ZK_AREA_NOT_FOUND","TEAM_ZK_AREA_PATH_STALE","TEAM_ZK_AREA_RELOCATION_PENDING","TEAM_ZK_AREA_RELOCATION_SPLIT","TEAM_ZK_AREA_REWRAP_ACTIVE","TEAM_ZK_AUTOMATION_REFUSED","TEAM_ZK_BUCKET_ENCRYPTED","TEAM_ZK_BUCKET_ROSTER_REQUIRED","TEAM_ZK_CONTENT_REPLACED","TEAM_ZK_COPY_GRANT_TEAM_ONLY","TEAM_ZK_COPY_KEY_INVALID","TEAM_ZK_COPY_KEY_TAKEN","TEAM_ZK_COPY_TICKET_INVALID","TEAM_ZK_DELIVERER_NOT_CONFIRMED","TEAM_ZK_DERIVATIVE_GRANT_TEAM_ONLY","TEAM_ZK_DERIVATIVE_KEY_INVALID","TEAM_ZK_DERIVATIVE_PHOTO_UNKNOWN","TEAM_ZK_DERIVATIVE_TICKET_INVALID","TEAM_ZK_DOOR_NAME_REQUIRED","TEAM_ZK_DOOR_RESTORE_GONE","TEAM_ZK_DOOR_SEALED_NAMES","TEAM_ZK_ENTRY_EXISTS","TEAM_ZK_ENTRY_ID_INVALID","TEAM_ZK_ENTRY_PARKED","TEAM_ZK_EPOCHS_NOT_DEMOTION","TEAM_ZK_EPOCHS_SELF","TEAM_ZK_EPOCH_INVALID","TEAM_ZK_ETAG_REQUIRED","TEAM_ZK_FOLD_ACTIVE","TEAM_ZK_FOLD_ROSTER_REQUIRED","TEAM_ZK_FOLD_WAITS_PASS","TEAM_ZK_GALLERY_NOT_STAMPED","TEAM_ZK_GALLERY_OWNER_KEY_REQUIRED","TEAM_ZK_GALLERY_PREFIX_SERVER_MADE","TEAM_ZK_HOLDER_NOT_ADMIN","TEAM_ZK_HOLDER_NO_VAULT","TEAM_ZK_HOLDER_REQUIRED","TEAM_ZK_INBOX_COPY_CURRENT","TEAM_ZK_INBOX_KEY_REUSED","TEAM_ZK_INBOX_KEY_STALE","TEAM_ZK_INBOX_REFUSED","TEAM_ZK_INBOX_REWRAP_REQUIRED","TEAM_ZK_INBOX_ROTATION_TEAM_ONLY","TEAM_ZK_INNER_AREA","TEAM_ZK_INVITE_COPIES_MISMATCH","TEAM_ZK_INVITE_ROW_EXISTS","TEAM_ZK_IN_USE","TEAM_ZK_KEY_CHANGED","TEAM_ZK_KEY_NOT_HELD","TEAM_ZK_LINK_RENEWAL_NOT_FOUND","TEAM_ZK_MOVE_ACROSS_LIMIT","TEAM_ZK_MOVE_CONFLICT_UNSUPPORTED","TEAM_ZK_MOVE_FOLDER_MISSING","TEAM_ZK_MOVE_LINKED","TEAM_ZK_MOVE_NOT_ENCRYPTED","TEAM_ZK_MOVE_OUT_REFUSED","TEAM_ZK_MOVE_OWN_ACCESS","TEAM_ZK_MOVE_PARENT_PENDING","TEAM_ZK_MOVE_PASS_REQUIRED","TEAM_ZK_MOVE_REFUSED","TEAM_ZK_MOVE_REWRAP_REQUIRED","TEAM_ZK_MOVE_ROW_CHANGED","TEAM_ZK_MOVE_UNREADABLE","TEAM_ZK_NAME_TOKENS_REQUIRED","TEAM_ZK_NAME_TOKEN_CLASH","TEAM_ZK_NOT_ENABLED","TEAM_ZK_OPAQUE_SEGMENT_REQUIRED","TEAM_ZK_PARKED_ITEMS_INVALID","TEAM_ZK_PARKED_KEY_MISMATCH","TEAM_ZK_PARKED_SEAL_INVALID","TEAM_ZK_PARK_NOT_DUE","TEAM_ZK_PASS_NOT_PAUSABLE","TEAM_ZK_PASS_PAUSED","TEAM_ZK_PERSON_NOT_CONFIRMED","TEAM_ZK_PIN_INVALID","TEAM_ZK_PIN_KEY_PAIR_MISSING","TEAM_ZK_RECOVERY_COPY_INVALID","TEAM_ZK_RECOVERY_KEY_INVALID","TEAM_ZK_RECOVERY_KEY_LOCKED","TEAM_ZK_RECOVERY_NOTICE_FAILED","TEAM_ZK_RECOVERY_NOT_PREPARED","TEAM_ZK_RENAME_REFUSED","TEAM_ZK_RENEWAL_DUE","TEAM_ZK_RENEWAL_ORDER","TEAM_ZK_REPARENT_UNAVAILABLE","TEAM_ZK_REPARENT_WAITS_PASS","TEAM_ZK_RESOURCE_ID_REQUIRED","TEAM_ZK_RESOURCE_ID_TAKEN","TEAM_ZK_RESOURCE_ID_TEAM_ONLY","TEAM_ZK_RESOURCE_KEY_BEHIND","TEAM_ZK_REWRAP_ITEMS_INVALID","TEAM_ZK_ROLE_UNCHANGED","TEAM_ZK_ROSTER_INVALID","TEAM_ZK_ROSTER_NOT_FOUND","TEAM_ZK_ROSTER_REQUIRED","TEAM_ZK_ROSTER_VERSION","TEAM_ZK_SAME_PASSWORD","TEAM_ZK_SEALS_INCOMPLETE","TEAM_ZK_SEALS_INVALID","TEAM_ZK_SERVER_MOVE_REFUSED","TEAM_ZK_SERVER_TRANSFER_REFUSED","TEAM_ZK_SIGNATURE_INVALID","TEAM_ZK_SPLIT_ACTIVE","TEAM_ZK_SPLIT_WAITS_PASS","TEAM_ZK_STALE_EPOCH","TEAM_ZK_SUCCESSION_INVALID","TEAM_ZK_TRANSFER_CONFLICT_UNSUPPORTED","TEAM_ZK_TRANSFER_KEYS_MISSING","TEAM_ZK_TRANSFER_MATERIAL_REQUIRED","TEAM_ZK_TRANSFER_NOT_ENCRYPTED","TEAM_ZK_TRANSFER_NOT_REENCRYPTED","TEAM_ZK_TRANSFER_OUT_REFUSED","TEAM_ZK_TRANSFER_PLAIN_IN_REFUSED","TEAM_ZK_TRANSFER_PLAIN_LINKED","TEAM_ZK_TRANSFER_READ_FAILED","TEAM_ZK_TRANSFER_REFUSED","TEAM_ZK_TRANSFER_REKEY_LIMIT","TEAM_ZK_TRANSFER_ROUTE_CHANGED","TEAM_ZK_TRANSFER_ROW_CHANGED","TEAM_ZK_TRANSFER_SEALS_MISSING","TEAM_ZK_TRANSFER_SEGMENT_REQUIRED","TEAM_ZK_TRANSFER_SIZE_UNKNOWN","TEAM_ZK_TRANSFER_USE_AREA_MOVE","TEAM_ZK_VAULT_REQUIRED","TEAM_ZK_WORK_NOT_CLAIMABLE","TEAM_ZK_WORK_REASON_UNSUPPORTED","TEMPORARY_REDIRECT","TENANCY_NOT_A_TEST_DATABASE","TENANT_NET_TEST_ONLY","TENANT_SCOPE_VIOLATION","THUMBNAIL_SOURCE_INVALID","THUMBNAIL_STAMP_INVALID","THUMBNAIL_STAMP_STALE","TOO_MANY_REQUESTS","TRASH_DESTINATION_ENCRYPTED","TRASH_LIST_CURSOR_INVALID","TRASH_PARENT_TRASHED","TRASH_RESTORE_CONFLICT","TRASH_REVEAL_BUCKET_REQUIRED","TRASH_ZK_ARRIVALS_PRESENT","TRASH_ZK_DOOR_REQUIRED","TRELLO_BOARD_MANAGE_FORBIDDEN","TRELLO_BOARD_NOT_CONNECTED","TRELLO_BOARD_NOT_FOUND","TRELLO_BOARD_NOT_MEMBER","TRELLO_BOARD_TAKEN","TRELLO_CARD_DESTINATION_REQUIRED","TRELLO_CARD_HAS_INBOX","TRELLO_CARD_INBOX_FORBIDDEN","TRELLO_CARD_INBOX_NOT_FOUND","TRELLO_CARD_MISMATCH","TRELLO_CARD_REQUIRED","TRELLO_ENCRYPTED_ITEM","TRELLO_GRANT_DENIED","TRELLO_GRANT_EXPIRED","TRELLO_GRANT_MISMATCH","TRELLO_GRANT_REQUIRED","TRELLO_GRANT_WORKSPACE","TRELLO_IDEMPOTENCY_KEY_INVALID","TRELLO_IDEMPOTENCY_KEY_REQUIRED","TRELLO_ITEM_NOT_FOUND","TRELLO_JWT_INVALID","TRELLO_JWT_REPLAYED","TRELLO_LINK_ALREADY","TRELLO_LINK_EXPIRED","TRELLO_LINK_NOT_FOUND","TRELLO_LINK_NOT_MEMBER","TRELLO_LINK_PAUSED","TRELLO_LINK_TAKEN","TRELLO_NOT_CONFIGURED","TRELLO_NOT_CONNECTED","TRELLO_NOT_LINKED","TRELLO_OUTSIDE_TEAM","TRELLO_PROJECT_HAS_BOARD","TRELLO_PROJECT_MANAGE_FORBIDDEN","TRELLO_REQUEST_IN_PROGRESS","TRELLO_TOO_MANY_ITEMS","TRELLO_TOO_MANY_REQUESTS","TRELLO_UNAVAILABLE","TWO_FACTOR_REQUIRED_BY_TEAM","UNAUTHORIZED","UNPROCESSABLE_ENTITY","UNRECOVERABLE_ERROR","UNSUBSCRIBE_INVALID_OR_EXPIRED","UNSUBSCRIBE_INVALID_SCOPE","UNSUBSCRIBE_NOT_AVAILABLE","UNSUBSCRIBE_USER_GONE","UNSUPPORTED_MEDIA_TYPE","UPTIME_INVALID_CURSOR","URI_TOO_LONG","USER_ACCOUNT_DELETION_RETRY","USER_ACCOUNT_MOVE_LANDING","USER_CURRENT_PASSWORD_INCORRECT","USER_EMAIL_CHANGE_INVALID","USER_EMAIL_CHANGE_NONE","USER_EMAIL_EXISTS","USER_EMAIL_UNCHANGED","USER_NOTIFICATION_TYPE_INVALID","USER_NOT_FOUND","USER_NOT_SCHEDULED_FOR_DELETION","USER_PASSWORD_INCORRECT","USER_PASSWORD_REQUIRED","USER_RENEWAL_NOT_CANCELLED","USER_SESSION_NOT_FOUND","USER_ZK_FILES_PRESENT","WEBHOOK_INVALID_SIGNATURE","WEBHOOK_MISSING_RAW_BODY","WEBHOOK_NOT_CONFIGURED","WORKSPACE_DISSOLVING","WORKSPACE_DRAFT_INACTIVE","WORKSPACE_DRAFT_PENDING","WORKSPACE_EMAIL_NOT_VERIFIED","WORKSPACE_EXPORT_CLIENT_GONE","WORKSPACE_EXPORT_DOWNLOAD_CLAIM_LOST","WORKSPACE_EXPORT_DOWNLOAD_RUNNING","WORKSPACE_EXPORT_NOT_FOUND","WORKSPACE_EXPORT_NOT_READY","WORKSPACE_EXPORT_OWNER_CHANGED","WORKSPACE_EXPORT_RUNNING","WORKSPACE_EXPORT_TARGET_LOST","WORKSPACE_EXPORT_TOO_LARGE","WORKSPACE_EXPORT_WORKER_LOST","WORKSPACE_HEADER_NOT_FOUND","WORKSPACE_LAST_ADMIN","WORKSPACE_LAST_OWNER","WORKSPACE_MEMBER_NOT_FOUND","WORKSPACE_NAME_MISMATCH","WORKSPACE_NOT_FOUND","WORKSPACE_OWNER_CANNOT_LEAVE","WORKSPACE_PHOTO_INVALID","WORKSPACE_PHOTO_TOO_LARGE","WORKSPACE_READ_ONLY","WORKSPACE_REAUTH_REQUIRED","WORKSPACE_ROLE_FORBIDDEN","WORKSPACE_SEATS_BELOW_USED","WORKSPACE_SEATS_EXHAUSTED","WORKSPACE_SHARING_DISABLED","WORKSPACE_SUSPENDED","WORKSPACE_TRANSFER_TARGET_NOT_ADMIN","WORKSPACE_TWO_FACTOR_REQUIRED","WORKSPACE_TWO_FACTOR_SELF_REQUIRED","ZK_ALREADY_ACTIVATED","ZK_CUSTODY_FIELDS_INVALID","ZK_CUSTODY_IMMUTABLE","ZK_DISCARD_CLEANUP_RUNNING","ZK_ENVELOPE_CONFLICT","ZK_FIELDS_INCOMPLETE","ZK_HANDOFF_NOT_FOUND","ZK_HANDOFF_NOT_NEEDED","ZK_KDF_MISMATCH","ZK_KDF_NOT_STRONGER","ZK_KDF_SALT_PINNED","ZK_KEYPAIR_CONFLICT","ZK_LEASE_HELD","ZK_LEASE_INVALID","ZK_NOT_ACTIVATED","ZK_NOT_AVAILABLE_IN_TEAM","ZK_NOT_RECIPIENT","ZK_OWNER_KEY_MISSING","ZK_PLAN_REQUIRED","ZK_RECIPIENTS_DUPLICATED","ZK_RECIPIENTS_REQUIRED","ZK_RECIPIENT_IS_OWNER","ZK_RECIPIENT_KEY_CHANGED","ZK_RECIPIENT_LAST","ZK_RECIPIENT_ONLY_PLAN_REQUIRED","ZK_RECOVERY_CODE_INVALID","ZK_REKEY_INCOMPLETE","ZK_REKEY_IN_PROGRESS","ZK_REKEY_KEY_MISSING","ZK_REKEY_KEY_SET","ZK_REKEY_NOT_FOUND","ZK_REKEY_REASON_INVALID","ZK_REKEY_RECIPIENT_UNKNOWN","ZK_REKEY_REQUIRED","ZK_REKEY_TARGET_INVALID","ZK_RESET_VAULT_NOT_LINKED","ZK_RESET_VAULT_PROOF_INVALID","ZK_RESOURCE_ORPHANED","ZK_UNREADABLE_ACK_REQUIRED","ZK_UNSUPPORTED_VERSION","ZK_VAULT_PASSWORD_INCORRECT","ZK_WORK_NOT_FOUND"],"example":"OK"},"timestamp":{"type":"string","format":"date-time"},"path":{"type":"string"},"requestId":{"type":"string","nullable":true,"format":"uuid","description":"The request id, also in the X-Request-Id header of API answers."},"details":{"type":"object","additionalProperties":true,"description":"Extra data some errors carry (limits, conflicting names)."}},"required":["statusCode","message","error","code","timestamp","path","requestId"]},"PublicApiWorkspaceResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"},"name":{"type":"string","example":"Estudio Norte","description":"The team name, or the account name for a personal space"},"kind":{"enum":["PERSONAL","TEAM"],"type":"string","example":"TEAM"}},"required":["id","name","kind"]},"PublicApiKeyReachItemResponseDto":{"type":"object","properties":{"kind":{"enum":["bucket","project"],"type":"string","example":"bucket"},"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5c"},"name":{"type":"string","example":"Clientes"}},"required":["kind","id","name"]},"PublicApiKeyInfoResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5d"},"name":{"type":"string","example":"Invoices to Drive"},"prefix":{"type":"string","example":"nbk_3jKF3m","description":"The start of the secret, as the app shows it"},"access":{"enum":["READ","WRITE"],"type":"string","example":"WRITE"},"allResources":{"type":"boolean","example":false,"description":"The key reaches the whole space"},"reach":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiKeyReachItemResponseDto"}},"expiresAt":{"type":"string","nullable":true,"format":"date-time","example":"2027-11-13T18:07:24.249Z"}},"required":["id","name","prefix","access","allResources","reach","expiresAt"]},"PublicApiQuotaAmountResponseDto":{"type":"object","properties":{"used":{"type":"number","example":1250},"limit":{"type":"number","example":50000},"remaining":{"type":"number","example":48750}},"required":["used","limit","remaining"]},"PublicApiQuotaResponseDto":{"type":"object","properties":{"periodStart":{"type":"string","format":"date-time","example":"2026-11-03T00:00:00.000Z"},"periodEnd":{"type":"string","format":"date-time","example":"2026-12-03T00:00:00.000Z"},"requests":{"description":"Metered calls this period","allOf":[{"$ref":"#/components/schemas/PublicApiQuotaAmountResponseDto"}]},"events":{"description":"Trigger items delivered this period","allOf":[{"$ref":"#/components/schemas/PublicApiQuotaAmountResponseDto"}]},"ratePerMinute":{"type":"number","example":60,"description":"Calls a minute for this key"}},"required":["periodStart","periodEnd","requests","events","ratePerMinute"]},"PublicApiMeResponseDto":{"type":"object","properties":{"workspace":{"$ref":"#/components/schemas/PublicApiWorkspaceResponseDto"},"plan":{"enum":["FREE","PERSONAL","PRO","TEAMS"],"type":"string","example":"PRO"},"key":{"$ref":"#/components/schemas/PublicApiKeyInfoResponseDto"},"quota":{"$ref":"#/components/schemas/PublicApiQuotaResponseDto"}},"required":["workspace","plan","key","quota"]},"PublicApiBucketResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"name":{"type":"string","example":"Facturas","description":"The name of the bucket in Nubbo"},"provider":{"enum":["AWS_S3","DO_SPACES","CLOUDFLARE_R2","WASABI","BACKBLAZE_B2","S3_CUSTOM"],"type":"string","example":"CLOUDFLARE_R2"},"region":{"type":"string","example":"auto"},"encrypted":{"type":"boolean","example":false,"description":"The whole bucket is encrypted: its files cannot be read or changed here"},"wholeBucket":{"type":"boolean","example":true,"description":"The key reaches the whole bucket; false when it reaches only some folders"},"blocked":{"type":"boolean","example":false,"description":"Over the plan limit of buckets: open Nubbo to choose which buckets stay active"}},"required":["id","name","provider","region","encrypted","wholeBucket","blocked"]},"PublicApiBucketPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiBucketResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiFileResponseDto":{"type":"object","properties":{"id":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61","description":"The file id; null on navigation folders"},"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"kind":{"enum":["file","folder"],"type":"string","example":"file"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted items carry only id, bucketId, kind, encrypted and dates, and refuse every action with API_ENCRYPTED_CONTENT"},"name":{"type":"string","example":"invoice-0042.pdf"},"path":{"type":"string","example":"invoices/2026/invoice-0042.pdf","description":"The path in the bucket; folders end with a slash"},"size":{"type":"number","nullable":true,"example":184320,"description":"Bytes; null for folders"},"mimeType":{"type":"string","nullable":true,"example":"application/pdf"},"labelIds":{"example":["0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a62"],"description":"Ids of the labels on the item","type":"array","items":{"type":"string"}},"hidden":{"type":"boolean","example":false,"description":"Hidden in Nubbo"},"navigation":{"type":"boolean","example":true,"description":"A folder above the reach of the key, listed only to reach the folders inside it; it has no id"},"modifiedAt":{"type":"string","format":"date-time","example":"2026-11-02T09:14:05.000Z"},"trashedAt":{"type":"string","nullable":true,"format":"date-time","example":null}},"required":["id","bucketId","kind","encrypted","modifiedAt","trashedAt"]},"PublicApiFilePageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiFileResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":"cHViLWFwaS1jdXJzb3I","description":"Opaque; send it as cursor with the same parameters for the next page"}},"required":["data","nextCursor"]},"PublicApiCreateFolderDto":{"type":"object","properties":{"path":{"type":"string","maxLength":1024,"pattern":"^(?!(?:.*\\/)?\\.\\.(?:\\/|$))[^<>:\"\\\\|?*\\x00-\\x1F]+$","example":"invoices/2026/11/","description":"The folder to create; missing parent folders are created with it"},"conflict":{"enum":["fail","rename","skip"],"type":"string","default":"fail","description":"When the folder exists: fail answers API_NAME_TAKEN, rename creates «name (1)», skip returns the existing folder (also from the trash, with trashedAt set)","example":"rename"}},"required":["path"]},"PublicApiCreateUploadDto":{"type":"object","properties":{"path":{"type":"string","maxLength":1024,"pattern":"^(?!.*\\/$)(?!(?:.*\\/)?\\.\\.(?:\\/|$))[^<>:\"\\\\|?*\\x00-\\x1F]+$","example":"invoices/2026/11/invoice-0042.pdf","description":"Where the file goes in the bucket, with its name"},"size":{"type":"number","minimum":0,"maximum":5497558138880,"example":184320,"description":"Bytes"},"contentType":{"type":"string","maxLength":255,"example":"application/pdf"},"conflict":{"enum":["fail","rename","replace"],"type":"string","default":"fail","description":"When a file with this path exists: fail answers API_NAME_TAKEN, rename uploads as «name (1)», replace overwrites it at the provider as the Nubbo app does (the previous content is not kept by Nubbo and does not go to the trash; a bucket with versioning keeps it as an older version at the provider)","example":"rename"},"multipart":{"type":"boolean","default":false,"description":"Upload in parts even below 5 GB (from 5 MiB). Above 5 GB uploads are always multipart"}},"required":["path","size"]},"PublicApiUploadResponseDto":{"type":"object","properties":{"uploadId":{"type":"string","example":"dXBsb2FkLXRva2Vu","description":"Opaque; only the key that started the upload can use it"},"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"path":{"type":"string","example":"invoices/2026/11/invoice-0042.pdf","description":"Where the file lands; with conflict=rename it can differ from the path sent"},"multipart":{"type":"boolean","example":false},"method":{"type":"string","example":"PUT","description":"Single uploads: send the file body with this method to url"},"url":{"type":"string","example":"https://facturas.example.com/invoices/2026/11/invoice-0042.pdf?X-Amz-Signature=…","description":"Single uploads: a presigned URL straight to the storage provider"},"partSize":{"type":"number","example":16777216,"description":"Multipart: bytes per part"},"totalParts":{"type":"number","example":640,"description":"Multipart: number of parts"},"expiresAt":{"type":"string","format":"date-time","example":"2026-11-13T19:00:00.000Z","description":"Single uploads: when url stops working. Multipart: when uploadId stops working (7 days)"}},"required":["uploadId","bucketId","path","multipart","expiresAt"]},"PublicApiDestinationDto":{"type":"object","properties":{"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"path":{"type":"string","maxLength":1024,"example":"invoices/paid/","description":"The destination folder; empty for the root of the bucket"}},"required":["bucketId","path"]},"PublicApiMoveDto":{"type":"object","properties":{"fileIds":{"minItems":1,"maxItems":1000,"example":["0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"],"type":"array","items":{"type":"string","format":"uuid"}},"destination":{"$ref":"#/components/schemas/PublicApiDestinationDto"},"conflict":{"enum":["fail","rename","skip"],"type":"string","default":"fail","description":"When an item with the same name is at the destination: fail answers API_NAME_TAKEN and moves nothing, rename moves it as «name (1)», skip leaves that item where it is","example":"rename"}},"required":["fileIds","destination"]},"PublicApiMoveResultResponseDto":{"type":"object","properties":{"status":{"enum":["queued","running","done","failed"],"type":"string","example":"done"},"moved":{"type":"number","example":3},"skipped":{"type":"number","example":0,"description":"Items left where they were with conflict=skip"},"failed":{"type":"number","example":0},"failedCodes":{"type":"object","additionalProperties":{"type":"number"},"example":{},"description":"How many items failed, by error code"}},"required":["status","moved","skipped","failed","failedCodes"]},"PublicApiQueuedResponseDto":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a70","description":"Follow it with GET /v1/operations/{operationId}"},"status":{"enum":["queued","running","done","failed"],"type":"string","example":"queued"}},"required":["operationId","status"]},"PublicApiFileIdsDto":{"type":"object","properties":{"fileIds":{"minItems":1,"maxItems":1000,"example":["0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"],"type":"array","items":{"type":"string","format":"uuid"}}},"required":["fileIds"]},"PublicApiBulkFailureResponseDto":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"},"code":{"type":"string","example":"TRASH_PARENT_TRASHED"},"message":{"type":"string","example":"The folder that held this item is in the trash"}},"required":["fileId","code","message"]},"PublicApiBulkResultResponseDto":{"type":"object","properties":{"done":{"example":["0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"],"type":"array","items":{"type":"string"}},"failed":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiBulkFailureResponseDto"}}},"required":["done","failed"]},"PublicApiDownloadLinkDto":{"type":"object","properties":{"expiresIn":{"type":"number","minimum":60,"maximum":604800,"default":3600,"example":3600,"description":"Seconds the link works, from 60 to 7 days"},"fileNameInLink":{"type":"boolean","default":true,"description":"false leaves the file name out of the link: the download is still forced, and browsers take the name from the path. For clients that decode and re-encode the link query, which breaks the encoded name."}}},"PublicApiDownloadLinkResponseDto":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"},"url":{"type":"string","example":"https://facturas.example.com/invoices/2026/invoice-0042.pdf?X-Amz-Signature=…","description":"A presigned GET straight to the storage provider"},"expiresAt":{"type":"string","format":"date-time","example":"2026-11-13T19:00:00.000Z"}},"required":["fileId","url","expiresAt"]},"PublicApiRenameDto":{"type":"object","properties":{"name":{"type":"string","maxLength":255,"pattern":"^(?!\\.\\.?$)(?!.*\\/)(?!(?:.*\\/)?\\.\\.(?:\\/|$))[^<>:\"\\\\|?*\\x00-\\x1F]+$","example":"invoice-0042-paid.pdf","description":"The new name, without a path; folders keep their place"},"conflict":{"enum":["fail","rename"],"type":"string","default":"fail","description":"When the name is taken: fail answers API_NAME_TAKEN, rename uses «name (1)»","example":"rename"}},"required":["name"]},"PublicApiFileLabelsResponseDto":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"},"labelIds":{"example":["0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a62"],"type":"array","items":{"type":"string"}}},"required":["fileId","labelIds"]},"PublicApiLabelResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a62"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted labels carry only id, encrypted and dates"},"name":{"type":"string","example":"Paid"},"color":{"type":"string","example":"#22c55e"},"description":{"type":"string","nullable":true,"example":"Invoices already paid"},"groupId":{"type":"string","nullable":true,"format":"uuid","example":null,"description":"The label group, or null outside any group"},"createdAt":{"type":"string","format":"date-time","example":"2026-10-01T10:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-11-01T10:00:00.000Z"}},"required":["id","encrypted","createdAt","updatedAt"]},"PublicApiLabelPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiLabelResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiCreateLabelDto":{"type":"object","properties":{"name":{"type":"string","maxLength":50,"example":"Paid"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#094ad7","description":"Hex colour; a palette colour is picked when it is left out"},"description":{"type":"string","maxLength":200,"example":"Invoices already paid"},"groupId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a64","description":"A label group of the space (GET /v1/label-groups)"}},"required":["name"]},"PublicApiUpdateLabelDto":{"type":"object","properties":{"name":{"type":"string","maxLength":50,"example":"Paid in full"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","example":"#0891b2"},"description":{"type":"string","maxLength":200,"example":"Invoices paid in full","description":"An empty string clears it"},"groupId":{"type":"string","nullable":true,"format":"uuid","example":null,"description":"A label group of the space, or null to take the label out of its group"}}},"PublicApiMergeLabelDto":{"type":"object","properties":{"intoId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a63","description":"The label that stays; files with this label get it, and this label is deleted"}},"required":["intoId"]},"PublicApiMergedLabelResponseDto":{"type":"object","properties":{"label":{"$ref":"#/components/schemas/PublicApiLabelResponseDto"},"merged":{"type":"number","example":1,"description":"Labels merged into it"},"files":{"type":"number","example":12,"description":"Files that carry the label now"}},"required":["label","merged","files"]},"PublicApiLabelGroupResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a64"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted groups carry only id, encrypted and dates"},"name":{"type":"string","example":"Accounting"},"createdAt":{"type":"string","format":"date-time","example":"2026-10-01T10:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-11-01T10:00:00.000Z"}},"required":["id","encrypted","createdAt","updatedAt"]},"PublicApiLabelGroupPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiLabelGroupResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiProjectResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a63"},"name":{"type":"string","example":"Marketing"},"color":{"type":"string","example":"#6366f1"},"archived":{"type":"boolean","example":false,"description":"Archived projects are read only in Nubbo"},"folderCount":{"type":"number","example":3,"description":"Folders of the project the key reaches"},"createdAt":{"type":"string","format":"date-time","example":"2026-09-01T08:00:00.000Z"},"lastActivityAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-11-12T16:20:00.000Z"}},"required":["id","name","color","archived","folderCount","createdAt","lastActivityAt"]},"PublicApiProjectPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiProjectResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiProjectFolderResponseDto":{"type":"object","properties":{"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted folders carry no path"},"path":{"type":"string","example":"campaigns/2026/","description":"Empty for a whole bucket"},"wholeBucket":{"type":"boolean","example":false},"missing":{"type":"boolean","example":false,"description":"The folder no longer exists in the bucket"},"trashed":{"type":"boolean","example":false,"description":"The folder is in the trash"}},"required":["bucketId","encrypted","wholeBucket","missing","trashed"]},"PublicApiProjectResourceCountsResponseDto":{"type":"object","properties":{"links":{"type":"number","example":4},"inboxes":{"type":"number","example":1},"galleries":{"type":"number","example":2},"embeds":{"type":"number","example":0},"automations":{"type":"number","example":1}},"required":["links","inboxes","galleries","embeds","automations"]},"PublicApiProjectDetailResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a63"},"name":{"type":"string","example":"Marketing"},"color":{"type":"string","example":"#6366f1"},"archived":{"type":"boolean","example":false,"description":"Archived projects are read only in Nubbo"},"folderCount":{"type":"number","example":3,"description":"Folders of the project the key reaches"},"createdAt":{"type":"string","format":"date-time","example":"2026-09-01T08:00:00.000Z"},"lastActivityAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-11-12T16:20:00.000Z"},"folders":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiProjectFolderResponseDto"}},"resourceCounts":{"$ref":"#/components/schemas/PublicApiProjectResourceCountsResponseDto"}},"required":["id","name","color","archived","folderCount","createdAt","lastActivityAt","folders","resourceCounts"]},"PublicApiProjectFolderRefDto":{"type":"object","properties":{"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"path":{"type":"string","maxLength":1024,"example":"clients/acme/","description":"A folder of the bucket; empty for the whole bucket"}},"required":["bucketId","path"]},"PublicApiProjectResourceRefDto":{"type":"object","properties":{"kind":{"enum":["link","inbox","gallery","embed","automation"],"type":"string","example":"link"},"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a66"}},"required":["kind","id"]},"PublicApiProjectItemsDto":{"type":"object","properties":{"folders":{"maxItems":500,"type":"array","items":{"$ref":"#/components/schemas/PublicApiProjectFolderRefDto"}},"resources":{"maxItems":500,"description":"Links, file requests (inbox), galleries, embeds and automation rules","type":"array","items":{"$ref":"#/components/schemas/PublicApiProjectResourceRefDto"}}}},"PublicApiUploadPartsDto":{"type":"object","properties":{"partNumbers":{"minItems":1,"maxItems":100,"items":{"type":"integer","minimum":1,"maximum":10000},"example":[1,2,3],"description":"Part numbers to sign, from 1 to totalParts","type":"array"}},"required":["partNumbers"]},"PublicApiUploadPartUrlResponseDto":{"type":"object","properties":{"partNumber":{"type":"number","example":1},"url":{"type":"string","example":"https://facturas.example.com/video.mp4?partNumber=1&uploadId=…&X-Amz-Signature=…","description":"Send the bytes of this part with PUT"}},"required":["partNumber","url"]},"PublicApiUploadPartsResponseDto":{"type":"object","properties":{"uploadId":{"type":"string","example":"dXBsb2FkLXRva2Vu"},"parts":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiUploadPartUrlResponseDto"}},"expiresAt":{"type":"string","format":"date-time","example":"2026-11-13T19:00:00.000Z"}},"required":["uploadId","parts","expiresAt"]},"PublicApiOperationErrorResponseDto":{"type":"object","properties":{"code":{"type":"string","example":"API_KEY_REVOKED"},"message":{"type":"string","example":"This API key was revoked"}},"required":["code","message"]},"PublicApiOperationResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a70"},"kind":{"enum":["move","transfer"],"type":"string","example":"move","description":"move inside one bucket, transfer between buckets"},"status":{"enum":["queued","running","done","failed"],"type":"string","example":"running"},"itemCount":{"type":"number","nullable":true,"example":1200},"failedCount":{"type":"number","example":0,"description":"Items that could not be moved"},"failedCodes":{"type":"object","additionalProperties":{"type":"number"},"example":{},"description":"How many items failed, by error code"},"error":{"nullable":true,"example":null,"type":"object","allOf":[{"$ref":"#/components/schemas/PublicApiOperationErrorResponseDto"}]},"createdAt":{"type":"string","format":"date-time","example":"2026-11-13T18:00:00.000Z"},"startedAt":{"type":"string","nullable":true,"format":"date-time","example":null},"finishedAt":{"type":"string","nullable":true,"format":"date-time","example":null}},"required":["id","kind","status","itemCount","failedCount","failedCodes","error","createdAt","startedAt","finishedAt"]},"PublicApiLinkResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a80"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted items carry only id, encrypted and dates, and refuse changes with API_ENCRYPTED_CONTENT"},"bucketAvailable":{"type":"boolean","example":true,"description":"false while the bucket cannot be reached (for example while it is being removed): only id, status and dates are shown and changes answer BUCKET_NOT_FOUND"},"kind":{"enum":["file","folder"],"type":"string","example":"file"},"fileId":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61","description":"The shared file or folder; null when it is gone or in the trash"},"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"path":{"type":"string","example":"invoices/2026/invoice-0042.pdf"},"name":{"type":"string","example":"invoice-0042.pdf"},"url":{"type":"string","example":"https://app.nubbo.app/s/Xk3pQ9","description":"The public link to send; anyone with it can open the share"},"status":{"enum":["active","paused","expired"],"type":"string","example":"active"},"hasPassword":{"type":"boolean","example":false},"maxDownloads":{"type":"number","nullable":true,"example":10},"downloadCount":{"type":"number","example":2},"viewCount":{"type":"number","example":5},"expiresAt":{"type":"string","nullable":true,"format":"date-time","example":null},"createdAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"}},"required":["id","encrypted","expiresAt","createdAt"]},"PublicApiLinkPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiLinkResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiCreateLinkDto":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61","description":"The file or folder to share"},"password":{"type":"string","minLength":4,"maxLength":50,"example":"open-sesame"},"expiresAt":{"type":"string","format":"date-time","example":"2026-11-20T00:00:00.000Z"},"maxDownloads":{"type":"number","minimum":1,"example":10}},"required":["fileId"]},"PublicApiUpdateLinkDto":{"type":"object","properties":{"active":{"type":"boolean","example":false,"description":"false pauses the link"},"password":{"type":"string","nullable":true,"minLength":4,"maxLength":50,"description":"null removes the password"},"expiresAt":{"type":"string","nullable":true,"format":"date-time","description":"null removes the expiry"},"maxDownloads":{"type":"number","nullable":true,"minimum":1,"description":"null removes the limit"}}},"PublicApiInboxResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a90"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted items carry only id, encrypted and dates, and refuse changes with API_ENCRYPTED_CONTENT"},"bucketAvailable":{"type":"boolean","example":true,"description":"false while the bucket cannot be reached (for example while it is being removed): only id, name, status and dates are shown and changes answer BUCKET_NOT_FOUND"},"name":{"type":"string","example":"Invoices from Acme"},"description":{"type":"string","nullable":true,"example":"Send this month’s invoices here"},"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"path":{"type":"string","example":"inbox/acme/","description":"Where uploads land"},"url":{"type":"string","example":"https://app.nubbo.app/r/Yh7Lm2"},"status":{"enum":["active","paused","expired"],"type":"string","example":"active","description":"paused means closed"},"hasPassword":{"type":"boolean","example":false},"maxFileSize":{"type":"number","nullable":true,"example":104857600,"description":"Bytes"},"allowedFileTypes":{"example":["pdf"],"type":"array","items":{"type":"string"}},"maxUploads":{"type":"number","nullable":true,"example":null},"uploadCount":{"type":"number","example":3},"visitorIdentity":{"enum":["required","optional","none"],"type":"string","example":"none"},"expiresAt":{"type":"string","nullable":true,"format":"date-time","example":null},"createdAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"}},"required":["id","encrypted","expiresAt","createdAt"]},"PublicApiInboxPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiInboxResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiCreateInboxDto":{"type":"object","properties":{"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"path":{"type":"string","maxLength":1024,"example":"inbox/acme/","description":"The folder uploads land in; empty for the root of the bucket"},"name":{"type":"string","maxLength":100,"example":"Invoices from Acme"},"description":{"type":"string","maxLength":500},"password":{"type":"string","minLength":4,"maxLength":50},"expiresAt":{"type":"string","format":"date-time","example":"2026-12-01T00:00:00.000Z"},"maxFileSize":{"type":"number","minimum":1,"description":"Bytes per file"},"allowedFileTypes":{"maxItems":50,"example":[".pdf"],"description":"File extensions accepted, with or without the leading dot and in any case (stored as .pdf); one extension each, so .tar.gz is refused (use .gz); empty accepts every type","type":"array","items":{"type":"string","maxLength":100}},"maxUploads":{"type":"number","minimum":1},"visitorIdentity":{"enum":["required","optional","none"],"type":"string","default":"none","example":"required"}},"required":["bucketId","path","name"]},"PublicApiUpdateInboxDto":{"type":"object","properties":{"name":{"type":"string","maxLength":100,"example":"Invoices from Acme"},"description":{"type":"string","nullable":true,"maxLength":500,"example":"Send this month’s invoices here"},"path":{"type":"string","maxLength":1024,"example":"inbox/acme/","description":"The folder uploads land in; empty for the root of the bucket"},"password":{"type":"string","nullable":true,"minLength":4,"maxLength":50,"description":"null removes the password"},"expiresAt":{"type":"string","nullable":true,"format":"date-time"},"maxFileSize":{"type":"number","nullable":true,"minimum":1,"description":"Bytes per file; null removes the limit"},"allowedFileTypes":{"maxItems":50,"example":[".pdf",".jpg"],"description":"File extensions accepted, with or without the leading dot and in any case (stored as .pdf); one extension each, so .tar.gz is refused (use .gz); empty accepts every type","type":"array","items":{"type":"string","maxLength":100}},"maxUploads":{"type":"number","nullable":true,"minimum":1,"description":"null removes the limit"},"visitorIdentity":{"enum":["required","optional","none"],"type":"string","description":"Ask senders for their name and email: required, optional or none","example":"required"},"active":{"type":"boolean","example":false,"description":"false closes the inbox; true reopens it"}}},"PublicApiInboxUploaderResponseDto":{"type":"object","properties":{"identified":{"type":"boolean","example":true,"description":"Whether the sender gave a name; who they are is shown in Nubbo"}},"required":["identified"]},"PublicApiInboxUploadResponseDto":{"type":"object","properties":{"fileId":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61","description":"The received file; null when it is gone, in the trash or still arriving"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted uploads, and uploads whose file is no longer there, carry only fileId, encrypted and uploadedAt"},"name":{"type":"string","example":"invoice-0042.pdf"},"path":{"type":"string","example":"inbox/acme/invoice-0042.pdf"},"size":{"type":"number","example":184320,"description":"Bytes"},"mimeType":{"type":"string","nullable":true,"example":"application/pdf"},"uploader":{"$ref":"#/components/schemas/PublicApiInboxUploaderResponseDto"},"uploadedAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"}},"required":["fileId","encrypted","uploadedAt"]},"PublicApiInboxUploadPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiInboxUploadResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiGalleryResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4aa0"},"encrypted":{"type":"boolean","example":false,"description":"Encrypted galleries carry only id, encrypted and dates, and refuse changes"},"bucketAvailable":{"type":"boolean","example":true,"description":"false while the bucket cannot be reached: only id, status and dates are shown and changes answer BUCKET_NOT_FOUND"},"folderId":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"},"bucketId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a60"},"path":{"type":"string","example":"shoots/summer/"},"title":{"type":"string","example":"Summer shoot"},"description":{"type":"string","nullable":true,"example":null},"layout":{"type":"string","enum":["masonry","grid","slideshow"],"example":"masonry"},"coverFileId":{"type":"string","nullable":true,"format":"uuid","example":null},"individualDownloads":{"type":"boolean","example":true},"zipDownload":{"type":"boolean","example":true},"watermarkText":{"type":"string","nullable":true,"example":null},"url":{"type":"string","example":"https://app.nubbo.app/g/Pq8Rt3"},"status":{"enum":["active","paused","expired"],"type":"string","example":"active"},"hasPassword":{"type":"boolean","example":false},"viewCount":{"type":"number","example":12},"downloadCount":{"type":"number","example":3},"expiresAt":{"type":"string","nullable":true,"format":"date-time","example":null},"createdAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"}},"required":["id","encrypted","expiresAt","createdAt"]},"PublicApiGalleryPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiGalleryResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiCreateGalleryDto":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61","description":"The folder whose photos and videos the gallery shows"},"title":{"type":"string","maxLength":200,"example":"Summer shoot"},"description":{"type":"string","maxLength":2000},"layout":{"enum":["masonry","grid","slideshow"],"type":"string","default":"masonry","example":"masonry"},"coverFileId":{"type":"string","format":"uuid","description":"A file inside the gallery folder"},"individualDownloads":{"type":"boolean","example":true},"zipDownload":{"type":"boolean","example":true},"password":{"type":"string","minLength":4,"maxLength":50},"expiresAt":{"type":"string","format":"date-time"},"watermarkText":{"type":"string","maxLength":100}},"required":["fileId","title"]},"PublicApiUpdateGalleryDto":{"type":"object","properties":{"title":{"type":"string","maxLength":200,"example":"Summer shoot"},"description":{"type":"string","nullable":true,"maxLength":2000},"layout":{"enum":["masonry","grid","slideshow"],"type":"string","example":"masonry"},"coverFileId":{"type":"string","nullable":true,"format":"uuid","description":"A file inside the gallery folder; null removes the cover"},"individualDownloads":{"type":"boolean","example":true,"description":"Visitors can download single files"},"zipDownload":{"type":"boolean","example":true,"description":"Visitors can download everything as a ZIP"},"password":{"type":"string","nullable":true,"minLength":4,"maxLength":50,"description":"null removes the password"},"expiresAt":{"type":"string","nullable":true,"format":"date-time"},"watermarkText":{"type":"string","nullable":true,"maxLength":100,"description":"A text watermark on the photos; null removes it"},"active":{"type":"boolean","example":true,"description":"false pauses the gallery"}}},"PublicApiEmbedSnippetResponseDto":{"type":"object","properties":{"html":{"type":"string","example":"<iframe src=\"https://app.nubbo.app/e/Zt4\" …></iframe>"},"react":{"type":"string","example":"<iframe src=\"https://app.nubbo.app/e/Zt4\" … />"},"url":{"type":"string","example":"https://app.nubbo.app/e/Zt4"}},"required":["html","react","url"]},"PublicApiEmbedResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4ab0"},"kind":{"type":"string","enum":["inbox","explorer","shared"],"example":"inbox"},"name":{"type":"string","example":"Upload box"},"status":{"enum":["active","paused","expired"],"type":"string","example":"active","description":"paused means the embed is paused"},"inboxId":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"},"linkId":{"type":"string","nullable":true,"format":"uuid","example":null},"bucketId":{"type":"string","nullable":true,"format":"uuid","example":null},"path":{"type":"string","nullable":true,"example":null},"allowedDomains":{"example":["example.com"],"type":"array","items":{"type":"string"}},"hasPassword":{"type":"boolean","example":false},"config":{"type":"object","additionalProperties":true,"example":{"presentation":"dropzone","locale":"auto"},"description":"The configuration the builder in Nubbo saves"},"snippet":{"description":"The code to paste in a page; absent in lists","allOf":[{"$ref":"#/components/schemas/PublicApiEmbedSnippetResponseDto"}]},"impressionCount":{"type":"number","example":42},"expiresAt":{"type":"string","nullable":true,"format":"date-time","example":null},"createdAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"}},"required":["id","kind","name","status","inboxId","linkId","bucketId","path","allowedDomains","hasPassword","config","impressionCount","expiresAt","createdAt","updatedAt"]},"PublicApiEmbedPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiEmbedResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"PublicApiCreateEmbedDto":{"type":"object","properties":{"allowedDomains":{"maxItems":20,"example":["example.com"],"description":"Sites allowed to show the embed; empty allows any site","type":"array","items":{"type":"string","maxLength":253}},"expiresAt":{"type":"string","nullable":true,"format":"date-time"},"password":{"type":"string","nullable":true,"minLength":4,"maxLength":128,"description":"Explorer embeds only; null removes the password"},"paused":{"type":"boolean","example":false,"description":"true pauses the embed"},"config":{"type":"object","additionalProperties":true,"description":"The look and behaviour of the embed, as the builder in Nubbo saves it. Optional: anything left out keeps the default of the kind, and a partial object is merged over it."},"kind":{"enum":["inbox","explorer","shared"],"type":"string","example":"inbox"},"name":{"type":"string","maxLength":100,"example":"Upload box"},"inboxId":{"type":"string","format":"uuid","description":"Inbox embeds: the file request"},"linkId":{"type":"string","format":"uuid","description":"Shared embeds: the share link"},"bucketId":{"type":"string","format":"uuid","description":"Explorer embeds: the bucket"},"path":{"type":"string","maxLength":1024,"example":"press/","description":"Explorer embeds: the folder shown; empty for the whole bucket"}},"required":["kind","name"]},"PublicApiUpdateEmbedDto":{"type":"object","properties":{"name":{"type":"string","maxLength":100,"example":"Upload box"},"allowedDomains":{"maxItems":20,"example":["example.com"],"description":"Sites allowed to show the embed; empty allows any site","type":"array","items":{"type":"string","maxLength":253}},"expiresAt":{"type":"string","nullable":true,"format":"date-time"},"password":{"type":"string","nullable":true,"minLength":4,"maxLength":128,"description":"Explorer embeds only; null removes the password"},"paused":{"type":"boolean","example":false,"description":"true pauses the embed"},"config":{"type":"object","additionalProperties":true,"description":"The look and behaviour of the embed, as the builder in Nubbo saves it. Optional: anything left out keeps the default of the kind, and a partial object is merged over it."}}},"PublicApiRouteCategoryResponseDto":{"type":"object","properties":{"name":{"type":"string","example":"Invoices"},"folder":{"type":"string","nullable":true,"example":"invoices/","description":"null when the folder is outside the reach of the key"}},"required":["name","folder"]},"PublicApiRouteConfigResponseDto":{"type":"object","properties":{"categories":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiRouteCategoryResponseDto"}},"fallbackFolder":{"type":"string","nullable":true,"example":"other/","description":"null when the folder is outside the reach of the key"},"rename":{"type":"boolean","example":false},"tag":{"type":"boolean","example":true}},"required":["categories","fallbackFolder","rename","tag"]},"PublicApiAutomationResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4ac0"},"name":{"type":"string","example":"File invoices by month"},"isActive":{"type":"boolean","example":true},"pausedReason":{"type":"string","nullable":true,"example":null,"description":"Why Nubbo paused it"},"trigger":{"enum":["FOLDER_UPLOAD","INBOX_UPLOAD","SCHEDULE","THRESHOLD","INACTIVITY"],"type":"string","example":"FOLDER_UPLOAD"},"action":{"enum":["TAG","MOVE","RENAME","NOTIFY","ROUTE","TRASH","COMPRESS","FAVORITE","HIDE","COPY_TO_BUCKET","MIRROR_TO_BUCKET","SHARE_LINK","SENSITIVE_SCAN","AI_PROMPT"],"type":"string","example":"MOVE"},"bucketId":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"},"folderPrefix":{"type":"string","example":"inbox/"},"fileRequestId":{"type":"string","nullable":true,"format":"uuid","example":null},"destinationFolder":{"type":"string","nullable":true,"example":null,"description":"null when the destination is outside the reach of the key"},"routeConfig":{"nullable":true,"example":null,"description":"ROUTE rules only (they use Nubbo AI, so keys can read them, never change them)","type":"object","allOf":[{"$ref":"#/components/schemas/PublicApiRouteConfigResponseDto"}]},"usesAi":{"type":"boolean","example":false,"description":"Rules that use Nubbo AI can be read, paused and deleted, never changed or resumed, through the API"},"apiKeyId":{"type":"string","nullable":true,"format":"uuid","example":null,"description":"The API key that last created or changed the rule; null after a change in Nubbo"},"lastRunAt":{"type":"string","nullable":true,"format":"date-time","example":null},"createdAt":{"type":"string","format":"date-time","example":"2026-11-14T09:00:00.000Z"}},"required":["id","name","isActive","pausedReason","trigger","action","bucketId","folderPrefix","fileRequestId","destinationFolder","routeConfig","usesAi","apiKeyId","lastRunAt","createdAt"]},"PublicApiAutomationPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiAutomationResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":null}},"required":["data","nextCursor"]},"AutomationRouteCategoryDto":{"type":"object","properties":{"name":{"type":"string","maxLength":30},"folder":{"type":"string","maxLength":512}},"required":["name","folder"]},"PublicApiCreateAutomationDto":{"type":"object","properties":{"name":{"type":"string","maxLength":100},"trigger":{"type":"string","enum":["FOLDER_UPLOAD","INBOX_UPLOAD","SCHEDULE","THRESHOLD","INACTIVITY"],"example":"FOLDER_UPLOAD"},"bucketId":{"type":"string","format":"uuid"},"folderPrefix":{"type":"string","maxLength":512},"fileRequestId":{"type":"string","format":"uuid"},"interval":{"type":"string","enum":["DAILY","WEEKLY","MONTHLY"],"example":"DAILY"},"action":{"type":"string","enum":["TAG","MOVE","RENAME","NOTIFY","ROUTE","TRASH","COMPRESS","FAVORITE","HIDE","COPY_TO_BUCKET","MIRROR_TO_BUCKET","SHARE_LINK","SENSITIVE_SCAN","AI_PROMPT"],"example":"TAG"},"destinationFolder":{"type":"string","maxLength":512},"routeCategories":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/AutomationRouteCategoryDto"}},"routeFallbackFolder":{"type":"string","maxLength":512},"routeRename":{"type":"boolean"},"routeTag":{"type":"boolean"},"trashOlderThanDays":{"type":"number","minimum":0,"maximum":3650},"compressDestinationFolder":{"type":"string","maxLength":512},"namePattern":{"type":"string","maxLength":100},"prompt":{"type":"string","maxLength":500},"promptOutput":{"type":"string","enum":["NOTIFY","DOCUMENT"],"example":"NOTIFY"},"copyDestBucketId":{"type":"string","format":"uuid"},"copyDestinationFolder":{"type":"string","maxLength":512},"copyMode":{"type":"string","enum":["copy","move"],"example":"copy"},"mirrorTrashOrphans":{"type":"boolean"},"shareExpiresInDays":{"type":"number","minimum":0,"maximum":365},"sharePassword":{"type":"string","minLength":4,"maxLength":50},"shareMaxDownloads":{"type":"number","minimum":0,"maximum":10000},"thresholdGb":{"type":"number","minimum":0.1,"maximum":1000000},"inactivityDays":{"type":"number","minimum":1,"maximum":3650}},"required":["name","trigger","action"]},"PublicApiUpdateAutomationDto":{"type":"object","properties":{"name":{"type":"string","maxLength":100},"isActive":{"type":"boolean"},"skipArrivals":{"type":"boolean"},"fileRequestId":{"type":"string","format":"uuid"},"folderPrefix":{"type":"string","maxLength":512},"interval":{"type":"string","enum":["DAILY","WEEKLY","MONTHLY"],"example":"DAILY"},"destinationFolder":{"type":"string","maxLength":512},"routeCategories":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/AutomationRouteCategoryDto"}},"routeFallbackFolder":{"type":"string","maxLength":512},"routeRename":{"type":"boolean"},"routeTag":{"type":"boolean"},"trashOlderThanDays":{"type":"number","minimum":0,"maximum":3650},"compressDestinationFolder":{"type":"string","maxLength":512},"namePattern":{"type":"string","maxLength":100},"prompt":{"type":"string","maxLength":500},"promptOutput":{"type":"string","enum":["NOTIFY","DOCUMENT"],"example":"NOTIFY"},"copyDestBucketId":{"type":"string","format":"uuid"},"copyDestinationFolder":{"type":"string","maxLength":512},"copyMode":{"type":"string","enum":["copy","move"],"example":"copy"},"mirrorTrashOrphans":{"type":"boolean"},"shareExpiresInDays":{"type":"number","minimum":0,"maximum":365},"sharePassword":{"type":"string","minLength":4,"maxLength":50},"shareMaxDownloads":{"type":"number","minimum":0,"maximum":10000},"thresholdGb":{"type":"number","minimum":0.1,"maximum":1000000},"inactivityDays":{"type":"number","minimum":1,"maximum":3650}}},"PublicApiActivityKeyResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a70"},"name":{"type":"string","example":"n8n invoices"}},"required":["id","name"]},"PublicApiActivityActorResponseDto":{"type":"object","properties":{"kind":{"enum":["person","integration","automation","visitor","system","ai"],"type":"string","example":"person","description":"Who acted: person (no name or email), integration (an API key or a file request upload with its integration password), automation (a rule), visitor (someone on a public link, file request or embed), system (Nubbo itself) or ai (Nubbo AI)"},"apiKey":{"description":"Present when an API key did it","allOf":[{"$ref":"#/components/schemas/PublicApiActivityKeyResponseDto"}]}},"required":["kind"]},"PublicApiActivityFileResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61"},"path":{"type":"string","example":"invoices/2026/march.pdf","description":"Absent when encrypted"},"name":{"type":"string","example":"march.pdf","description":"Absent when encrypted"}},"required":["id"]},"PublicApiActivityResourceResponseDto":{"type":"object","properties":{"type":{"enum":["SHARE","GALLERY","FILE_REQUEST","AUTOMATION_RULE","LABEL","SAVED_SEARCH","EXPORT","OPERATION","SESSION","PASSWORD_REVEAL","EMBED","LABEL_GROUP","INVITE","BUCKET_GROUP","PROJECT","WORKSPACE_MEMBER","WORKSPACE_INVITE","FOLDER_GRANT","WORKSPACE_DOMAIN","JOIN_REQUEST","WORKSPACE_EXPORT","TEAM_VAULT","TEAM_KEY_AREA","API_KEY","SLACK","TRELLO"],"type":"string","example":"FILE_REQUEST"},"id":{"type":"string","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a80"}},"required":["type","id"]},"PublicApiActivityResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a90"},"occurredAt":{"format":"date-time","type":"string","example":"2026-03-14T10:15:00.000Z"},"type":{"enum":["FILE_UPLOADED","FOLDER_CREATED","FILE_RENAMED","FILES_MOVED","FILE_EDITED","TRANSFER_COMPLETED","TRANSFER_FAILED","TRANSFER_CANCELLED","TRANSFER_PAUSED","TRANSFER_RESUMED","FILE_OPERATION_FAILED","FOLDER_SYNC_REQUESTED","AI_DOCUMENT_CREATED","FILE_DOWNLOADED","FILES_DOWNLOADED","FAVORITE_ADDED","FAVORITE_REMOVED","FILES_HIDDEN","FILES_UNHIDDEN","LABELS_ASSIGNED","LABELS_UNASSIGNED","LABEL_CREATED","LABEL_EDITED","LABEL_RENAMED","LABEL_DELETED","LABELS_MERGED","LABEL_GROUP_CREATED","LABEL_GROUP_EDITED","LABEL_GROUP_RENAMED","LABEL_GROUP_DELETED","BUCKET_GROUP_CREATED","BUCKET_GROUP_EDITED","BUCKET_GROUP_RENAMED","BUCKET_GROUP_DELETED","BUCKET_MOVED_TO_GROUP","PROJECT_CREATED","PROJECT_RENAMED","PROJECT_EDITED","PROJECT_ARCHIVED","PROJECT_UNARCHIVED","PROJECT_DELETED","PROJECT_ITEMS_ADDED","PROJECT_ITEMS_REMOVED","TRASH_SENT","TRASH_RESTORED","TRASH_DELETED","TRASH_PURGED","SHARE_CREATED","SHARE_EDITED","SHARE_REVOKED","SHARE_EXPIRED","SHARE_FIRST_VISIT","SHARE_DOWNLOAD_CLAIMED","SHARE_ZK_CONVERTED","INVITE_CREATED","INVITE_EDITED","INVITE_REVOKED","INVITE_ACCEPTED","INVITE_EXPIRED","INVITE_FIRST_ACCESS","INVITE_RECEIVED","INVITE_DOWNLOAD","INVITE_LEFT","SHARE_APPROVAL_REQUESTED","SHARE_APPROVAL_APPROVED","SHARE_APPROVAL_REJECTED","SHARE_APPROVAL_EXPIRED","SHARE_APPROVAL_CANCELLED","FILE_REQUEST_CREATED","FILE_REQUEST_EDITED","FILE_REQUEST_DELETED","FILE_REQUEST_EXPIRED","FILE_REQUEST_FIRST_VISIT","FILE_REQUEST_VISITOR_REGISTERED","FILE_REQUEST_RECEIVED","FILE_REQUEST_ZK_ADOPTED","FILE_REQUEST_ZK_CONVERTED","GALLERY_CREATED","GALLERY_EDITED","GALLERY_DELETED","GALLERY_EXPIRED","GALLERY_FIRST_VISIT","GALLERY_VISITOR_REGISTERED","GALLERY_PHOTO_LIKED","GALLERY_DOWNLOAD_CLAIMED","GALLERY_ZIP_DOWNLOADED","GALLERY_ZK_CONVERTED","GALLERY_COMMENTED","GALLERY_CLIENT_INVITED","GALLERY_DELIVERY_SENT","GALLERY_CURATED","GALLERY_INDEXED","AUTOMATION_RULE_CREATED","AUTOMATION_RULE_EDITED","AUTOMATION_RULE_DELETED","AUTOMATION_RULE_PAUSED","AUTOMATION_RULE_RESUMED","AUTOMATION_EXECUTED","RULE_REASSIGNED","RULE_PAUSED_CREATOR_REMOVED","EMBED_CREATED","EMBED_EDITED","EMBED_DUPLICATED","EMBED_PAUSED","EMBED_RESUMED","EMBED_TOKEN_ROTATED","EMBED_DELETED","EMBED_FIRST_VISIT","EMBED_EXPIRED","EMBED_FILE_UPLOADED","EMBED_FOLDER_CREATED","EMBED_FILE_DELETED","EMBEDS_PLAN_PAUSED","EMBEDS_PLAN_RESUMED"],"type":"string","example":"FILE_UPLOADED"},"actor":{"$ref":"#/components/schemas/PublicApiActivityActorResponseDto"},"bucketId":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a50"},"file":{"nullable":true,"description":"The file or folder it is about, while it still exists","type":"object","allOf":[{"$ref":"#/components/schemas/PublicApiActivityFileResponseDto"}]},"resource":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/PublicApiActivityResourceResponseDto"}]},"encrypted":{"type":"boolean","example":false,"description":"Encrypted rows carry no path, name or detail"},"detail":{"type":"object","additionalProperties":true,"example":{"fileName":"march.pdf","size":48213},"description":"Some facts of the event, depending on the type: name, previous, title, count, failed, size. They name files, folders, labels, projects, links, file requests, galleries, rules and embeds, never people. File names are left out when the file is no longer within reach."}},"required":["id","occurredAt","type","actor","bucketId","file","resource","encrypted","detail"]},"PublicApiActivityPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiActivityResponseDto"}},"nextCursor":{"type":"string","nullable":true,"example":"cHViLWFwaS1jdXJzb3I","description":"Opaque; send it as cursor with the same parameters for the next page"}},"required":["data","nextCursor"]},"PublicApiTriggerItemResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a90"},"occurredAt":{"format":"date-time","type":"string","example":"2026-03-14T10:15:00.000Z"},"type":{"enum":["FILE_UPLOADED","FOLDER_CREATED","FILE_RENAMED","FILES_MOVED","FILE_EDITED","TRANSFER_COMPLETED","TRANSFER_FAILED","TRANSFER_CANCELLED","TRANSFER_PAUSED","TRANSFER_RESUMED","FILE_OPERATION_FAILED","FOLDER_SYNC_REQUESTED","AI_DOCUMENT_CREATED","FILE_DOWNLOADED","FILES_DOWNLOADED","FAVORITE_ADDED","FAVORITE_REMOVED","FILES_HIDDEN","FILES_UNHIDDEN","LABELS_ASSIGNED","LABELS_UNASSIGNED","LABEL_CREATED","LABEL_EDITED","LABEL_RENAMED","LABEL_DELETED","LABELS_MERGED","LABEL_GROUP_CREATED","LABEL_GROUP_EDITED","LABEL_GROUP_RENAMED","LABEL_GROUP_DELETED","BUCKET_GROUP_CREATED","BUCKET_GROUP_EDITED","BUCKET_GROUP_RENAMED","BUCKET_GROUP_DELETED","BUCKET_MOVED_TO_GROUP","PROJECT_CREATED","PROJECT_RENAMED","PROJECT_EDITED","PROJECT_ARCHIVED","PROJECT_UNARCHIVED","PROJECT_DELETED","PROJECT_ITEMS_ADDED","PROJECT_ITEMS_REMOVED","TRASH_SENT","TRASH_RESTORED","TRASH_DELETED","TRASH_PURGED","SHARE_CREATED","SHARE_EDITED","SHARE_REVOKED","SHARE_EXPIRED","SHARE_FIRST_VISIT","SHARE_DOWNLOAD_CLAIMED","SHARE_ZK_CONVERTED","INVITE_CREATED","INVITE_EDITED","INVITE_REVOKED","INVITE_ACCEPTED","INVITE_EXPIRED","INVITE_FIRST_ACCESS","INVITE_RECEIVED","INVITE_DOWNLOAD","INVITE_LEFT","SHARE_APPROVAL_REQUESTED","SHARE_APPROVAL_APPROVED","SHARE_APPROVAL_REJECTED","SHARE_APPROVAL_EXPIRED","SHARE_APPROVAL_CANCELLED","FILE_REQUEST_CREATED","FILE_REQUEST_EDITED","FILE_REQUEST_DELETED","FILE_REQUEST_EXPIRED","FILE_REQUEST_FIRST_VISIT","FILE_REQUEST_VISITOR_REGISTERED","FILE_REQUEST_RECEIVED","FILE_REQUEST_ZK_ADOPTED","FILE_REQUEST_ZK_CONVERTED","GALLERY_CREATED","GALLERY_EDITED","GALLERY_DELETED","GALLERY_EXPIRED","GALLERY_FIRST_VISIT","GALLERY_VISITOR_REGISTERED","GALLERY_PHOTO_LIKED","GALLERY_DOWNLOAD_CLAIMED","GALLERY_ZIP_DOWNLOADED","GALLERY_ZK_CONVERTED","GALLERY_COMMENTED","GALLERY_CLIENT_INVITED","GALLERY_DELIVERY_SENT","GALLERY_CURATED","GALLERY_INDEXED","AUTOMATION_RULE_CREATED","AUTOMATION_RULE_EDITED","AUTOMATION_RULE_DELETED","AUTOMATION_RULE_PAUSED","AUTOMATION_RULE_RESUMED","AUTOMATION_EXECUTED","RULE_REASSIGNED","RULE_PAUSED_CREATOR_REMOVED","EMBED_CREATED","EMBED_EDITED","EMBED_DUPLICATED","EMBED_PAUSED","EMBED_RESUMED","EMBED_TOKEN_ROTATED","EMBED_DELETED","EMBED_FIRST_VISIT","EMBED_EXPIRED","EMBED_FILE_UPLOADED","EMBED_FOLDER_CREATED","EMBED_FILE_DELETED","EMBEDS_PLAN_PAUSED","EMBEDS_PLAN_RESUMED"],"type":"string","example":"FILE_UPLOADED"},"actor":{"$ref":"#/components/schemas/PublicApiActivityActorResponseDto"},"bucketId":{"type":"string","nullable":true,"format":"uuid","example":"0193a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a50"},"file":{"nullable":true,"description":"The file or folder it is about, while it still exists","type":"object","allOf":[{"$ref":"#/components/schemas/PublicApiActivityFileResponseDto"}]},"resource":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/PublicApiActivityResourceResponseDto"}]},"encrypted":{"type":"boolean","example":false,"description":"Encrypted rows carry no path, name or detail"},"detail":{"type":"object","additionalProperties":true,"example":{"fileName":"march.pdf","size":48213},"description":"Some facts of the event, depending on the type: name, previous, title, count, failed, size. They name files, folders, labels, projects, links, file requests, galleries, rules and embeds, never people. File names are left out when the file is no longer within reach."},"cursor":{"type":"string","example":"cHViLWFwaS1jdXJzb3I","description":"Opaque; send it as since, with the same filter, to resume right after this item"}},"required":["id","occurredAt","type","actor","bucketId","file","resource","encrypted","detail","cursor"]},"PublicApiTriggerPageResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicApiTriggerItemResponseDto"}},"nextCursor":{"type":"string","example":"cHViLWFwaS1jdXJzb3I","description":"Send it as since on the next poll, with the same filter"},"hasMore":{"type":"boolean","example":false,"description":"More new items are waiting (with since, or when the monthly events ran out); poll again after a minute"},"truncated":{"type":"boolean","example":false,"description":"With since: the cursor is older than the activity the plan keeps, so some items may be gone; the answer starts from the oldest kept"}},"required":["data","nextCursor","hasMore","truncated"]}}}}