{ "components": { "schemas": { "BlueskyFeedSearchPostsExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.search_posts", "input": { "limit": 10, "max_pages": 2, "query": "bluesky" } }, "properties": { "capability": { "enum": [ "bluesky.feed.search_posts" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedSearchPostsInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "BlueskyFeedGetTrendingTopicsInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "title": "Bluesky get trending topics input", "type": "object" }, "BlueskyActorGetFollowersCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.actor.get_followers" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "JobPendingResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "bluesky.actor.get_followers", "bluesky.actor.get_follows", "bluesky.actor.get_profile", "bluesky.actor.resolve_handle", "bluesky.actor.search", "bluesky.feed.get_author_feed", "bluesky.feed.get_feed", "bluesky.feed.get_feed_generators", "bluesky.feed.get_likes", "bluesky.feed.get_post_thread", "bluesky.feed.get_reposted_by", "bluesky.feed.get_trending_topics", "bluesky.feed.search_posts" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "state": { "enum": [ "queued", "running", "retrying" ], "type": "string" } }, "required": [ "job_id", "request_id", "platform", "capability", "state" ], "type": "object" }, "BlueskyFeedGetFeedGeneratorsInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "maxLength": 512, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "title": "Bluesky get feed generators input", "type": "object" }, "BlueskyActorGetFollowersExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.actor.get_followers", "input": { "actor": "bsky.app", "limit": 20, "max_pages": 2 } }, "properties": { "capability": { "enum": [ "bluesky.actor.get_followers" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyActorGetFollowersInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "BlueskyFeedGetTrendingTopicsExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.get_trending_topics", "input": { "limit": 25 } }, "properties": { "capability": { "enum": [ "bluesky.feed.get_trending_topics" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedGetTrendingTopicsInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "BlueskyFeedGetFeedExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.get_feed", "input": { "feed": "at://did:plc:3h5kz5x2n4q2w3f5n6z5b7b7/app.bsky.feed.generator/science", "limit": 20, "max_pages": 2 } }, "properties": { "capability": { "enum": [ "bluesky.feed.get_feed" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedGetFeedInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "JobBilling": { "additionalProperties": false, "properties": { "credits_charged": { "anyOf": [ { "description": "Actual credits charged. Null only when retained historical facts cannot establish the amount.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "credits_per_unit": { "anyOf": [ { "description": "Snapshotted price for one billed unit. Zero only for historical free work; null when unknown.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "model": { "enum": [ "per_request", "per_record", "free", "unknown" ], "type": "string" }, "pricing": { "additionalProperties": false, "properties": { "rule_id": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "enum": [ "module", "platform", "capability" ], "type": "string" }, { "type": "null" } ] }, "source": { "enum": [ "manifest", "price_book" ], "type": "string" }, "version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ] } }, "required": [ "source", "scope", "version", "rule_id" ], "type": "object" }, "units": { "anyOf": [ { "description": "Billed units under the stated model. Null when units do not apply or cannot be established.", "minimum": 0, "type": "integer" }, { "type": "null" } ] } }, "required": [ "model", "units", "credits_per_unit", "credits_charged", "pricing" ], "type": "object" }, "BlueskyFeedGetAuthorFeedExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.get_author_feed", "input": { "actor": "bsky.app", "limit": 10, "max_pages": 2 } }, "properties": { "capability": { "enum": [ "bluesky.feed.get_author_feed" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedGetAuthorFeedInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "UnauthorizedError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "unauthorized", "type": "string" }, "message": { "enum": [ "authentication required", "invalid bearer token", "missing bearer token" ], "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "BlueskyFeedGetAuthorFeedInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "actor": { "pattern": "\\S", "type": "string" }, "cursor": { "maxLength": 512, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "required": [ "actor" ], "title": "Bluesky author feed input", "type": "object" }, "JobStats": { "additionalProperties": false, "properties": { "duration_ms": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "failed": { "const": 0, "type": "integer" }, "passed": { "const": 1, "type": "integer" }, "total": { "const": 1, "type": "integer" } }, "required": [ "total", "passed", "failed", "duration_ms" ], "type": "object" }, "BlueskyFeedGetRepostedByCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.get_reposted_by" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyFeedGetFeedGeneratorsExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.get_feed_generators", "input": { "limit": 10, "max_pages": 1 } }, "properties": { "capability": { "enum": [ "bluesky.feed.get_feed_generators" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedGetFeedGeneratorsInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "InternalError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "internal_error", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "BlueskyFeedGetPostThreadExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.get_post_thread", "input": { "depth": 25, "uri": "at://did:plc:4zvfsavw2f4t6o3o3r6h4j6n/app.bsky.feed.post/3ltw5y5q3qv2g" } }, "properties": { "capability": { "enum": [ "bluesky.feed.get_post_thread" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedGetPostThreadInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "CredentialsRequiredError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "credentials_required", "type": "string" }, "message": { "const": "this capability requires authentication credentials; save them via POST /credentials", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "BlueskyFeedGetLikesInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "maxLength": 2048, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "uri": { "maxLength": 2048, "pattern": "\\S", "type": "string" } }, "required": [ "uri" ], "title": "Bluesky get likes input", "type": "object" }, "BlueskyFeedGetTrendingTopicsCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.get_trending_topics" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "JobErrorObject": { "additionalProperties": false, "properties": { "code": { "description": "Machine-readable error code (e.g. forbidden, not_found, invalid_input, upstream_timeout, upstream_error).", "type": "string" }, "message": { "description": "Human-readable error description.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "BlueskyFeedSearchPostsCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.search_posts" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyActorGetFollowsCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.actor.get_follows" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyFeedGetLikesExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.get_likes", "input": { "limit": 25, "max_pages": 2, "uri": "at://did:plc:4zvfsavw2f4t6o3o3r6h4j6n/app.bsky.feed.post/3ltw5y5q3qv2g" } }, "properties": { "capability": { "enum": [ "bluesky.feed.get_likes" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedGetLikesInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "ValidationErrors": { "additionalProperties": false, "properties": { "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "type": "object" } }, "required": [ "errors" ], "type": "object" }, "QuotaError": { "oneOf": [ { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "account_inactive", "type": "string" }, "message": { "const": "an active paid account is required", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "quota_exhausted", "type": "string" }, "message": { "const": "request quota exhausted for current billing period", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ] }, "BlueskyActorGetFollowsInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "actor": { "pattern": "\\S", "type": "string" }, "cursor": { "maxLength": 512, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "required": [ "actor" ], "title": "Bluesky get follows input", "type": "object" }, "BlueskyFeedGetFeedGeneratorsCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.get_feed_generators" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyActorGetProfileExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.actor.get_profile", "input": { "actor": "bsky.app" } }, "properties": { "capability": { "enum": [ "bluesky.actor.get_profile" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyActorGetProfileInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "BlueskyActorSearchCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.actor.search" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "JobFailedResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "bluesky.actor.get_followers", "bluesky.actor.get_follows", "bluesky.actor.get_profile", "bluesky.actor.resolve_handle", "bluesky.actor.search", "bluesky.feed.get_author_feed", "bluesky.feed.get_feed", "bluesky.feed.get_feed_generators", "bluesky.feed.get_likes", "bluesky.feed.get_post_thread", "bluesky.feed.get_reposted_by", "bluesky.feed.get_trending_topics", "bluesky.feed.search_posts" ], "type": "string" }, "error": { "$ref": "#/components/schemas/JobErrorObject" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "type": "null" }, "state": { "const": "failed", "type": "string" }, "stats": { "type": "null" }, "success": { "const": false, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "error", "results", "stats" ], "type": "object" }, "ExecuteNetwork": { "additionalProperties": false, "properties": { "session_id": { "description": "Optional explicit session identifier.", "minLength": 1, "type": "string" }, "session_key": { "description": "Optional stable key used to derive a reusable session.", "minLength": 1, "type": "string" }, "sticky": { "description": "Whether the request should reuse the resolved session.", "type": "boolean" } }, "type": "object" }, "BlueskyFeedGetAuthorFeedCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.get_author_feed" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyActorGetProfileCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.actor.get_profile" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyFeedGetLikesCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.get_likes" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyActorResolveHandleInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "handle": { "pattern": "\\S", "type": "string" }, "limit": { "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "required": [ "handle" ], "title": "Bluesky resolve handle input", "type": "object" }, "ExecuteAcceptedResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "bluesky.actor.get_followers", "bluesky.actor.get_follows", "bluesky.actor.get_profile", "bluesky.actor.resolve_handle", "bluesky.actor.search", "bluesky.feed.get_author_feed", "bluesky.feed.get_feed", "bluesky.feed.get_feed_generators", "bluesky.feed.get_likes", "bluesky.feed.get_post_thread", "bluesky.feed.get_reposted_by", "bluesky.feed.get_trending_topics", "bluesky.feed.search_posts" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "state": { "const": "queued", "type": "string" } }, "required": [ "job_id", "request_id", "platform", "capability", "state" ], "type": "object" }, "BlueskyActorResolveHandleCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.actor.resolve_handle" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyActorSearchExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.actor.search", "input": { "limit": 10, "max_pages": 2, "query": "bluesky" } }, "properties": { "capability": { "enum": [ "bluesky.actor.search" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyActorSearchInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "RateLimitError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "rate_limited", "type": "string" }, "message": { "const": "rate limit exceeded", "type": "string" }, "retry_after_ms": { "description": "Milliseconds until the rolling window resets enough to retry. The `retry-after` response header carries the same value rounded up to seconds.", "minimum": 0, "type": "integer" } }, "required": [ "code", "message", "retry_after_ms" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "ExecuteReplayResponse": { "additionalProperties": false, "description": "Replayed response matching the original job's current state (completed, failed, or pending).", "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.actor.get_followers", "bluesky.actor.get_follows", "bluesky.actor.get_profile", "bluesky.actor.resolve_handle", "bluesky.actor.search", "bluesky.feed.get_author_feed", "bluesky.feed.get_feed", "bluesky.feed.get_feed_generators", "bluesky.feed.get_likes", "bluesky.feed.get_post_thread", "bluesky.feed.get_reposted_by", "bluesky.feed.get_trending_topics", "bluesky.feed.search_posts" ], "type": "string" }, "error": {}, "idempotent_replay": { "const": true, "type": "boolean" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": {}, "state": { "enum": [ "queued", "running", "retrying", "completed", "failed" ], "type": "string" }, "stats": {}, "success": { "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "idempotent_replay" ], "type": "object" }, "BlueskyFeedGetPostThreadCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.get_post_thread" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "NotFoundError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "not_found", "type": "string" }, "message": { "const": "job not found", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "BlueskyFeedGetRepostedByExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.feed.get_reposted_by", "input": { "limit": 25, "max_pages": 2, "uri": "at://did:plc:4zvfsavw2f4t6o3o3r6h4j6n/app.bsky.feed.post/3ltw5y5q3qv2g" } }, "properties": { "capability": { "enum": [ "bluesky.feed.get_reposted_by" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyFeedGetRepostedByInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "IdempotencyConflictError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "idempotency_conflict", "type": "string" }, "message": { "const": "idempotency key has already been used for a different request", "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "BlueskyActorResolveHandleExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.actor.resolve_handle", "input": { "handle": "bsky.app" } }, "properties": { "capability": { "enum": [ "bluesky.actor.resolve_handle" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyActorResolveHandleInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "BlueskyActorGetFollowsExecuteRequest": { "additionalProperties": false, "example": { "capability": "bluesky.actor.get_follows", "input": { "actor": "bsky.app", "limit": 20, "max_pages": 2 } }, "properties": { "capability": { "enum": [ "bluesky.actor.get_follows" ], "type": "string" }, "input": { "$ref": "#/components/schemas/BlueskyActorGetFollowsInput" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 120000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "BlueskyFeedGetFeedCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "bluesky.feed.get_feed" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "bluesky" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee." }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "results", "billing", "stats" ], "type": "object" }, "BlueskyActorSearchInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "maxLength": 512, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "query": { "pattern": "\\S", "type": "string" } }, "required": [ "query" ], "title": "Bluesky actor search input", "type": "object" }, "BlueskyFeedGetPostThreadInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "depth": { "maximum": 100, "minimum": 1, "type": "integer" }, "limit": { "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "uri": { "maxLength": 2048, "pattern": "\\S", "type": "string" } }, "required": [ "uri" ], "title": "Bluesky get post thread input", "type": "object" }, "BlueskyFeedSearchPostsInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "maxLength": 512, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "query": { "pattern": "\\S", "type": "string" } }, "required": [ "query" ], "title": "Bluesky search posts input", "type": "object" }, "BlueskyActorGetProfileInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "actor": { "pattern": "\\S", "type": "string" }, "limit": { "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "required": [ "actor" ], "title": "Bluesky get profile input", "type": "object" }, "BlueskyActorGetFollowersInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "actor": { "pattern": "\\S", "type": "string" }, "cursor": { "maxLength": 512, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "required": [ "actor" ], "title": "Bluesky get followers input", "type": "object" }, "BlueskyFeedGetRepostedByInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "maxLength": 2048, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" }, "uri": { "maxLength": 2048, "pattern": "\\S", "type": "string" } }, "required": [ "uri" ], "title": "Bluesky get reposted by input", "type": "object" }, "BlueskyFeedGetFeedInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "maxLength": 2048, "type": "string" }, "feed": { "maxLength": 2048, "pattern": "\\S", "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "max_pages": { "maximum": 50, "minimum": 1, "type": "integer" }, "max_records": { "minimum": 1, "type": "integer" } }, "required": [ "feed" ], "title": "Bluesky get feed input", "type": "object" } }, "securitySchemes": { "BearerAuth": { "bearerFormat": "API Key", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Read public Bluesky profiles, actors, posts, and social graph data through AT Protocol public endpoints.\nThis spec includes only the live `Bluesky` capabilities exposed by Upscrape.\nExecution uses the generic `POST /execute` endpoint and job polling uses `GET /jobs/{id}`.\nSupported capabilities: `bluesky.actor.get_followers`, `bluesky.actor.get_follows`, `bluesky.actor.get_profile`, `bluesky.actor.resolve_handle`, `bluesky.actor.search`, `bluesky.feed.get_author_feed`, `bluesky.feed.get_feed`, `bluesky.feed.get_feed_generators`, `bluesky.feed.get_likes`, `bluesky.feed.get_post_thread`, `bluesky.feed.get_reposted_by`, `bluesky.feed.get_trending_topics`, `bluesky.feed.search_posts`\n## Rate limiting\n\nRequests are rate-limited per API key at **1200 requests per minute** on a rolling window. Every response includes `x-ratelimit-limit`, `x-ratelimit-remaining`, and `x-ratelimit-reset` (Unix ms) headers so clients can self-pace. When the limit is exceeded the API returns `429` with a `rate_limited` error body and a `retry-after` header in seconds plus a `retry_after_ms` field on the body for finer-grained backoff.", "title": "Bluesky API", "version": "v0.1.1" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/execute": { "post": { "description": "All executions are asynchronous. Submit a capability-specific payload to `POST /execute`, then poll the returned `job_id`.", "operationId": "bluesky_execute", "parameters": [ { "description": "Optional idempotency key. Reusing the same key with the same request replays the original job.", "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "maxLength": 255, "type": "string" } }, { "description": "Request synchronous completion. Use `wait=N` to hold the connection up to N seconds (max 300). If the job completes within the window, the response is `200` with full results (same shape as `GET /jobs/{id}`). If not, the response is the normal `202` with a `job_id` for polling. Omit this header for default asynchronous behavior.", "examples": { "wait30": { "summary": "Wait up to 30 seconds", "value": "wait=30" }, "wait5": { "summary": "Wait up to 5 seconds", "value": "wait=5" } }, "in": "header", "name": "Prefer", "required": false, "schema": { "example": "wait=30", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "capability": "bluesky.actor.get_followers", "input": { "actor": "bsky.app", "limit": 20, "max_pages": 2 } }, "schema": { "discriminator": { "mapping": { "bluesky.actor.get_followers": "#/components/schemas/BlueskyActorGetFollowersExecuteRequest", "bluesky.actor.get_follows": "#/components/schemas/BlueskyActorGetFollowsExecuteRequest", "bluesky.actor.get_profile": "#/components/schemas/BlueskyActorGetProfileExecuteRequest", "bluesky.actor.resolve_handle": "#/components/schemas/BlueskyActorResolveHandleExecuteRequest", "bluesky.actor.search": "#/components/schemas/BlueskyActorSearchExecuteRequest", "bluesky.feed.get_author_feed": "#/components/schemas/BlueskyFeedGetAuthorFeedExecuteRequest", "bluesky.feed.get_feed": "#/components/schemas/BlueskyFeedGetFeedExecuteRequest", "bluesky.feed.get_feed_generators": "#/components/schemas/BlueskyFeedGetFeedGeneratorsExecuteRequest", "bluesky.feed.get_likes": "#/components/schemas/BlueskyFeedGetLikesExecuteRequest", "bluesky.feed.get_post_thread": "#/components/schemas/BlueskyFeedGetPostThreadExecuteRequest", "bluesky.feed.get_reposted_by": "#/components/schemas/BlueskyFeedGetRepostedByExecuteRequest", "bluesky.feed.get_trending_topics": "#/components/schemas/BlueskyFeedGetTrendingTopicsExecuteRequest", "bluesky.feed.search_posts": "#/components/schemas/BlueskyFeedSearchPostsExecuteRequest" }, "propertyName": "capability" }, "oneOf": [ { "$ref": "#/components/schemas/BlueskyActorGetFollowersExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyActorGetFollowsExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyActorGetProfileExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyActorResolveHandleExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyActorSearchExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedGetAuthorFeedExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedGeneratorsExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedGetLikesExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedGetPostThreadExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedGetRepostedByExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedGetTrendingTopicsExecuteRequest" }, { "$ref": "#/components/schemas/BlueskyFeedSearchPostsExecuteRequest" } ] } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/BlueskyActorGetFollowersCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorGetFollowsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorGetProfileCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorResolveHandleCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorSearchCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetAuthorFeedCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedGeneratorsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetLikesCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetPostThreadCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetRepostedByCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetTrendingTopicsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedSearchPostsCompletedJob" }, { "$ref": "#/components/schemas/ExecuteReplayResponse" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Job completed within the `Prefer: wait` window, or existing job replayed via idempotency key.", "headers": { "Preference-Applied": { "description": "Present when the server honored the `Prefer: wait` preference.", "schema": { "example": "wait=30", "type": "string" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "bluesky.actor.get_followers", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "bluesky", "request_id": "00000000-0000-0000-0000-000000000001", "state": "queued", "success": false }, "schema": { "$ref": "#/components/schemas/ExecuteAcceptedResponse" } } }, "description": "Job accepted and queued.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } }, "description": "The authenticated account cannot execute the request." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdempotencyConflictError" } } }, "description": "Idempotency conflict" }, "422": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ValidationErrors" }, { "$ref": "#/components/schemas/CredentialsRequiredError" } ] } } }, "description": "The request body failed validation." }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 } }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InternalError" } } }, "description": "Unexpected server error" } }, "security": [ { "BearerAuth": [] } ], "summary": "Queue a Bluesky capability run", "tags": [ "Execution" ] } }, "/jobs/{id}": { "get": { "description": "Get job status and result", "operationId": "bluesky_getJob", "parameters": [ { "description": "The job ID returned by `POST /execute`.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/BlueskyActorGetFollowersCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorGetFollowsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorGetProfileCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorResolveHandleCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorSearchCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetAuthorFeedCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedGeneratorsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetLikesCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetPostThreadCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetRepostedByCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetTrendingTopicsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedSearchPostsCompletedJob" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Completed or terminal job state.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "bluesky.actor.get_followers", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "bluesky", "request_id": "00000000-0000-0000-0000-000000000001", "state": "running", "success": false }, "schema": { "$ref": "#/components/schemas/JobPendingResponse" } } }, "description": "Job is still queued, running, or retrying.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotFoundError" } } }, "description": "Job not found" }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 } }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } } }, "security": [ { "BearerAuth": [] } ], "summary": "Poll a Bluesky job", "tags": [ "Jobs" ] } }, "/jobs/{id}/result": { "get": { "description": "Backward-compatible alias for `/jobs/{id}`.", "operationId": "bluesky_getJobResult", "parameters": [ { "description": "The job ID returned by `POST /execute`.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/BlueskyActorGetFollowersCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorGetFollowsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorGetProfileCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorResolveHandleCompletedJob" }, { "$ref": "#/components/schemas/BlueskyActorSearchCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetAuthorFeedCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetFeedGeneratorsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetLikesCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetPostThreadCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetRepostedByCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedGetTrendingTopicsCompletedJob" }, { "$ref": "#/components/schemas/BlueskyFeedSearchPostsCompletedJob" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Completed or terminal job state.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "bluesky.actor.get_followers", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "bluesky", "request_id": "00000000-0000-0000-0000-000000000001", "state": "running", "success": false }, "schema": { "$ref": "#/components/schemas/JobPendingResponse" } } }, "description": "Job is still queued, running, or retrying.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotFoundError" } } }, "description": "Job not found" }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 } }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } } }, "security": [ { "BearerAuth": [] } ], "summary": "Poll a Bluesky job", "tags": [ "Jobs" ] } } }, "servers": [ { "url": "https://data.upscrape.com" } ], "tags": [ { "description": "Submit asynchronous capability runs.", "name": "Execution" }, { "description": "Poll queued jobs for status and results.", "name": "Jobs" } ] }