{"openapi":"3.0.3","info":{"title":"Inblog API","version":"1.0.0","description":"Manage blog content using the Inblog API.\n\n## πŸš€ Getting Started\n\n### 1. Get API Key\nGet your API key from the dashboard:\n1. Login to [Inblog Dashboard](https://inblog.ai/dashboard)\n2. Navigate to Settings β†’ API Keys\n3. Click \"Create New API Key\" button\n4. Select required permission scopes\n5. Store your API key securely\n\n### 2. First Request\n```bash\ncurl -X GET https://inblog.ai/api/v1/me \\\n -H \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n### 3. Use npm developer tools\nIf you prefer not to call the API manually, install the CLI:\n```bash\nnpm install -g @inblog/cli\ninblog auth login\n```\nFor AI coding assistants, install AI Skills:\n```bash\nnpx @inblog/ai-skills\n```\nThe CLI manages posts, images, tags, authors, redirects, forms, analytics, and blog settings from your terminal. AI Skills install Inblog workflows for tools such as Codex, Claude Code, Cursor, GitHub Copilot, and Gemini.\nRead the [Developer Tools guide](/docs/developer-tools/inblog-cli-and-ai-skills).\n\n### 4. Content-Type\n- **Request**: `Content-Type: application/json` or `application/vnd.api+json`\n- **Response**: `Content-Type: application/vnd.api+json`\n\n## πŸ“‹ Key Features\n\n- **Post Management**: Create, update, delete, and publish posts\n- **Tags and Authors**: Manage categories and author information\n- **Blog Settings**: Modify basic settings\n- **URL Redirects**: Configure 307 (temporary) and 308 (permanent) redirects\n- **Forms & Responses**: View lead capture forms and submission data\n- **JSON:API Standard**: Consistent response format\n\n## πŸ” Authentication\n\nAll API requests require Bearer token authentication via Authorization header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n## πŸ“š Learn More\n\n- [JSON:API Specification](https://jsonapi.org/)","contact":{"name":"Inblog Support","email":"contact@email.inblog.ai"},"license":{"name":"Proprietary"}},"servers":[{"url":"https://inblog.ai/api/v1","description":"Production API"},{"url":"http://localhost:3000/api/v1","description":"Local development"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Authentication","description":"## Authentication API\nCheck information about your currently active API key."},{"name":"Blogs","description":"## Blogs API\n\nManage basic blog information and settings.\n\n### Key Features\n- Update blog name and description\n- Configure timezone\n- Set default language\n- Manage logo and favicon URLs"},{"name":"Posts","description":"## Posts API\n\nCreate, update, delete, and publish blog posts.\n\n### Key Features\n- Create, read, and update posts\n- Manage post status (draft, published, scheduled)"},{"name":"Post Tags","description":"## Post-Tag Relationships API\n\nManage relationships between posts and tags.\n\n### Key Features\n- Add tags to posts\n- Remove tags from posts\n- List tags for a post"},{"name":"Post Authors","description":"## Post-Author Relationships API\n\nManage relationships between posts and authors. A single post can have multiple authors.\n\n### Key Features\n- Add authors to posts\n- Remove authors from posts\n- List authors for a post"},{"name":"Tags","description":"## Tags API\n\nCreate and manage blog tags.\n\n### Key Features\n- Create, update, and delete tags"},{"name":"Authors","description":"\n## Authors API\n\nView profile information for blog authors.\n\n### Key Features\n\n- View author profiles\n"},{"name":"Redirects","description":"## Redirects API\n\nConfigure and manage URL redirect rules.\n\n### Key Features\n- View redirect rules within your blog\n- Configure 307 (temporary) / 308 (permanent) redirects"},{"name":"Forms","description":"## Forms API\n\nView lead capture forms.\n\n### Key Features\n- List all forms\n- Get individual form details"},{"name":"Form Responses","description":"## Form Responses API\n\nView form submission data.\n\n### Key Features\n- List form responses (filterable by form ID)\n- Get individual form response details"},{"name":"Custom Domain","description":"## Custom Domain API\nManage custom domain configuration for your blog.\n### Key Features\n- Add a custom domain\n- Check domain DNS and verification status\n- Remove a custom domain"},{"name":"Custom UI","description":"## Custom UI API\nManage blog banner and UI customization.\n### Key Features\n- Get current banner and UI settings\n- Update banner image, title, colors, and navigation"},{"name":"Design Code","description":"## Design Code API\nManage custom design code for your blog.\n### Key Features\n- Get custom banner, layout, CSS, header, and footer code\n- Partially update individual design code fields"},{"name":"Search Console","description":"## Search Console API\nConnect and query Google Search Console data for your blog.\n### Key Features\n- OAuth-based Search Console connection\n- Keyword performance data (clicks, impressions, CTR, position)\n- Page-level search performance"},{"name":"Analytics","description":"## Analytics API\nAccess blog traffic analytics and performance metrics.\n### Key Features\n- Blog-wide traffic trends (daily/hourly)\n- Per-post performance metrics (visits, clicks, organic, CVR)\n- Traffic source analysis (referrers)\n- Individual post traffic and sources"}],"paths":{"/me":{"get":{"tags":["Authentication"],"summary":"Get My API Key Information","description":"Retrieve information and permissions for the currently active API key.\n\nView connected blog and list of granted permissions.\n","operationId":"getMe","responses":{"200":{"description":"API key information retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ApiKeyResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/user/blogs":{"get":{"tags":["Blogs"],"summary":"List Accessible Blogs","description":"Retrieve the list of blogs the currently authenticated user can access, including permission metadata.\n","operationId":"listUserBlogs","security":[{"jwtAuth":[]}],"responses":{"200":{"description":"Accessible blogs retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/UserBlogListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/upload":{"post":{"tags":["Blogs"],"summary":"Upload Image File","description":"Upload an image file and receive a public URL.\n\n**Request flow:**\n- Pass the destination key via the `fileKey` query parameter.\n- Send the raw file bytes as the request body.\n- Allowed MIME types: `image/png`, `image/jpeg`, `image/gif`, `image/webp`, `image/x-icon`\n\n**Limits:**\n- Maximum file size: 10MB\n- Upload rate limiting applies.\n","operationId":"uploadImage","security":[{"bearerAuth":[]}],"x-inblog-required-scopes-by-file-key-prefix":{"unprefixed":["posts:write"],"post-image":["posts:write"],"post_image":["posts:write"],"featured_image":["posts:write"],"social_post_image":["posts:write"],"avatar":["authors:write"],"favicon":["blogs:write"],"logo":["blogs:write"],"og_image":["blogs:write"],"banner":["blogs:write"],"not_found":["blogs:write"]},"parameters":[{"name":"fileKey","in":"query","required":true,"description":"Destination object key. Example: `post-image/2026-04-02T10:00:00.000Z-uuid`","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/gif":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"image/x-icon":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Upload completed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"413":{"description":"Uploaded file exceeds the 10MB limit"},"429":{"description":"Too many upload requests"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/posts":{"get":{"tags":["Posts"],"summary":"List Posts","description":"Retrieve a list of published posts from the blog.\nYou can specify page number and size, and include tag or author information.\n\nThe post body (content_html) is not included in list responses. Request it explicitly with fields[posts] when you need it.\n","operationId":"listPosts","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:read"],"parameters":[{"$ref":"#/components/parameters/PageParam"},{"$ref":"#/components/parameters/LimitParam"},{"$ref":"#/components/parameters/FieldsPostsParam"},{"$ref":"#/components/parameters/IncludeParam"},{"$ref":"#/components/parameters/FilterSlugParam"},{"$ref":"#/components/parameters/FilterPublishedParam"},{"$ref":"#/components/parameters/FilterPublishedAtGteParam"},{"$ref":"#/components/parameters/FilterPublishedAtLteParam"},{"$ref":"#/components/parameters/FilterTagIdParam"},{"$ref":"#/components/parameters/FilterAuthorIdParam"},{"$ref":"#/components/parameters/FilterContentTypeParam"},{"$ref":"#/components/parameters/SortParam"},{"$ref":"#/components/parameters/OrderParam"}],"responses":{"200":{"description":"Post list retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"post":{"tags":["Posts"],"summary":"Create Post","description":"Create a new blog post.\n\n**Required Fields:**\n- title: Post title\n- slug: URL slug (must be unique within the blog)\n\n**Image Processing:**\nExternal image URLs are uploaded to Inblog R2 storage by default.\nTo preserve original URLs, use the `preserve_external_images=true` query parameter.\n\n**Limitations:**\n- The id field is not allowed. Post ID is generated automatically by the server.\n- To update an existing post, use PATCH /posts/{id}.\n\n**Response Codes:**\n- 201: Post created successfully\n- 400: Bad request (e.g., id field included)\n- 409: Slug already exists\n\nExternal image URLs will be automatically saved to Inblog storage.\n","operationId":"createPost","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write"],"x-inblog-required-scopes-by-relationship":{"tags":["tags:write"],"authors":["authors:write"]},"parameters":[{"name":"preserve_external_images","in":"query","required":false,"description":"Preserve external image URLs instead of uploading to R2 storage","schema":{"type":"boolean","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCreateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostCreateRequest"}}}},"responses":{"201":{"description":"Post created successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/posts/{id}":{"get":{"tags":["Posts"],"summary":"Get Post","description":"Retrieve detailed information for a specific post by ID.","operationId":"getPost","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer","example":123}},{"$ref":"#/components/parameters/IncludeParam"}],"responses":{"200":{"description":"Post retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Posts"],"summary":"Update Post","description":"Update the content and settings of an existing post.\n\n**Image Processing:**\nExternal image URLs are uploaded to Inblog R2 storage by default.\nTo preserve original URLs, use the `preserve_external_images=true` query parameter.\n","operationId":"updatePost","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write"],"x-inblog-required-scopes-by-relationship":{"tags":["tags:write"],"authors":["authors:write"]},"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}},{"name":"preserve_external_images","in":"query","required":false,"description":"Preserve external image URLs instead of uploading to R2 storage","schema":{"type":"boolean","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostUpdateRequest"}}}},"responses":{"200":{"description":"Post updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"put":{"tags":["Posts"],"summary":"Update Post (PUT)","description":"Update a post using PUT. The current implementation treats PUT and PATCH identically.\n","operationId":"replacePost","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write"],"x-inblog-required-scopes-by-relationship":{"tags":["tags:write"],"authors":["authors:write"]},"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}},{"name":"preserve_external_images","in":"query","required":false,"description":"Preserve external image URLs instead of uploading to R2 storage","schema":{"type":"boolean","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostUpdateRequest"}}}},"responses":{"200":{"description":"Post updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"delete":{"tags":["Posts"],"summary":"Delete Post","description":"Permanently delete a post. This action cannot be undone.\n","operationId":"deletePost","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:delete"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"responses":{"204":{"description":"Post deleted successfully"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/posts/{id}/publish":{"patch":{"tags":["Posts"],"summary":"Publish Post","description":"Publish a post immediately or schedule it for later.\n\n**Supported Actions**:\n- `publish` - Publish immediately\n- `unpublish` - Unpublish\n- `schedule` - Schedule publication (future time only)\n","operationId":"publishPost","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishActionRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PublishActionRequest"}}}},"responses":{"200":{"description":"Publish status changed successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/posts/{id}/tags":{"get":{"tags":["Post Tags"],"summary":"List Post Tags","description":"Retrieve the list of tags associated with a post.","operationId":"getPostTags","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:read","tags:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"responses":{"200":{"description":"Tag list retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"post":{"tags":["Post Tags"],"summary":"Add Tags to Post","description":"Add one or more tags to a post.\nAlready connected tags are automatically skipped.\n","operationId":"addPostTags","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write","tags:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/ResourceIdentifier"},{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}}]}},"required":["data"]}]}},"application/vnd.api+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/ResourceIdentifier"},{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}}]}},"required":["data"]}]}}}},"responses":{"200":{"description":"Tags added successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagListResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Post Tags"],"summary":"Replace Post Tags","description":"Replace all tags on a post with a new set of tags.\nAll existing tags are removed and only the newly specified tags remain.\n","operationId":"replacePostTags","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write","tags:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}},{"type":"object","nullable":true,"enum":[null],"description":"Remove all tags"}]}},"required":["data"]}]}},"application/vnd.api+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}},{"type":"object","nullable":true,"enum":[null],"description":"Remove all tags"}]}},"required":["data"]}]}}}},"responses":{"200":{"description":"Tags replaced successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagListResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/posts/{id}/tags/{tagId}":{"delete":{"tags":["Post Tags"],"summary":"Remove Tag from Post","description":"Remove a specific tag from a post.","operationId":"removePostTag","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write","tags:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}},{"name":"tagId","in":"path","required":true,"description":"Tag ID","schema":{"type":"integer"}}],"responses":{"204":{"description":"Tag removed successfully"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/posts/{id}/authors":{"get":{"tags":["Post Authors"],"summary":"List Post Authors","description":"Retrieve the list of authors associated with a post.","operationId":"getPostAuthors","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:read","authors:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"responses":{"200":{"description":"Author list retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"post":{"tags":["Post Authors"],"summary":"Add Authors to Post","description":"Add one or more authors to a post.\nAlready connected authors are automatically skipped.\n","operationId":"addPostAuthors","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write","authors:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/ResourceIdentifier"},{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}}]}},"required":["data"]}]}},"application/vnd.api+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/ResourceIdentifier"},{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}}]}},"required":["data"]}]}}}},"responses":{"200":{"description":"Authors added successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorListResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Post Authors"],"summary":"Replace Post Authors","description":"Replace all authors on a post with a new set of authors.\nAll existing authors are removed and only the newly specified authors remain.\n","operationId":"replacePostAuthors","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write","authors:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}},{"type":"object","nullable":true,"enum":[null],"description":"Remove all authors"}]}},"required":["data"]}]}},"application/vnd.api+json":{"schema":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}},{"type":"object","nullable":true,"enum":[null],"description":"Remove all authors"}]}},"required":["data"]}]}}}},"responses":{"200":{"description":"Authors replaced successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorListResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/posts/{id}/authors/{authorId}":{"delete":{"tags":["Post Authors"],"summary":"Remove Author from Post","description":"Remove a specific author from a post.","operationId":"removePostAuthor","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["posts:write","authors:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}},{"name":"authorId","in":"path","required":true,"description":"Author ID (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Author removed successfully"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/tags":{"get":{"tags":["Tags"],"summary":"List Tags","description":"Retrieve all tags registered in the blog.","operationId":"listTags","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["tags:read"],"responses":{"200":{"description":"Tag list retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"post":{"tags":["Tags"],"summary":"Create Tag","description":"Create a new tag.\n\n**Required Fields:**\n- name: Tag name\n- slug: URL slug (must be unique within the blog)\n\n**Response Codes:**\n- 201: Tag created successfully\n- 409: Slug already exists\n","operationId":"createTag","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["tags:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagCreateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagCreateRequest"}}}},"responses":{"201":{"description":"Tag created successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/tags/{id}":{"get":{"tags":["Tags"],"summary":"Get Tag","description":"Retrieve detailed information for a specific tag by ID.","operationId":"getTag","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["tags:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Tag ID","schema":{"type":"integer"}}],"responses":{"200":{"description":"Tag retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Tags"],"summary":"Update Tag","description":"Update a tag's name or other information.","operationId":"updateTag","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["tags:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Tag ID","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagUpdateRequest"}}}},"responses":{"200":{"description":"Tag updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"put":{"tags":["Tags"],"summary":"Update Tag (PUT)","description":"Update a tag using PUT. The current implementation treats PUT and PATCH identically.\n","operationId":"replaceTag","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["tags:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Tag ID","schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagUpdateRequest"}}}},"responses":{"200":{"description":"Tag updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/TagResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"delete":{"tags":["Tags"],"summary":"Delete Tag","description":"Delete a tag. Existing post-tag relations are removed together with the tag.\n","operationId":"deleteTag","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["tags:delete"],"parameters":[{"name":"id","in":"path","required":true,"description":"Tag ID","schema":{"type":"integer"}}],"responses":{"204":{"description":"Tag deleted successfully"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/authors":{"get":{"tags":["Authors"],"summary":"List Authors","description":"Retrieve all author profiles registered in the blog.","operationId":"listAuthors","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["authors:read"],"parameters":[{"$ref":"#/components/parameters/PageParam"},{"$ref":"#/components/parameters/LimitParam"}],"responses":{"200":{"description":"Author list retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/authors/{id}":{"get":{"tags":["Authors"],"summary":"Get Author","description":"Retrieve profile information for a specific author.","operationId":"getAuthor","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["authors:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Author ID (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Author retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Authors"],"summary":"Update Author","description":"Update an author's profile information.\n\n**Editable Fields:**\n- author_name: Author display name\n- avatar_url: Profile image URL\n\n**Image Processing:**\nProfile image URLs are uploaded to Inblog R2 storage by default.\nTo preserve original URLs, use the `preserve_external_images=true` query parameter.\n","operationId":"updateAuthor","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["authors:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Author ID (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"preserve_external_images","in":"query","required":false,"description":"Preserve external image URLs instead of uploading to R2 storage","schema":{"type":"boolean","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorUpdateRequest"}}}},"responses":{"200":{"description":"Author updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"put":{"tags":["Authors"],"summary":"Update Author (PUT)","description":"Update an author's profile information using PUT.\n\n**Editable Fields:**\n- author_name: Author display name\n- avatar_url: Profile image URL\n\n**Image Processing:**\nProfile image URLs are uploaded to Inblog R2 storage by default.\nTo preserve original URLs, use the `preserve_external_images=true` query parameter.\n","operationId":"replaceAuthor","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["authors:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Author ID (UUID)","schema":{"type":"string","format":"uuid"}},{"name":"preserve_external_images","in":"query","required":false,"description":"Preserve external image URLs instead of uploading to R2 storage","schema":{"type":"boolean","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorUpdateRequest"}}}},"responses":{"200":{"description":"Author updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/AuthorResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"delete":{"tags":["Authors"],"summary":"Remove Author From Blog","description":"Remove the author's associations from posts in this blog. The author profile itself is not deleted.","operationId":"deleteAuthor","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["authors:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Author ID (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Author removed successfully"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/me":{"get":{"tags":["Blogs"],"summary":"Get My Blog","description":"Retrieve information about the blog connected to the current API key.","operationId":"getMyBlog","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"responses":{"200":{"description":"Blog retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BlogResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Blogs"],"summary":"Update My Blog Settings","description":"Update basic settings like blog name, description, logo, favicon, and featured image.\n\n**Image Processing:**\nLogo, favicon, and featured image URLs are uploaded to Inblog R2 storage by default.\nTo preserve original URLs, use the `preserve_external_images=true` query parameter.\n","operationId":"updateMyBlog","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:write"],"parameters":[{"name":"preserve_external_images","in":"query","required":false,"description":"Preserve external image URLs instead of uploading to R2 storage","schema":{"type":"boolean","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlogUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BlogUpdateRequest"}}}},"responses":{"200":{"description":"Blog updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BlogResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"put":{"tags":["Blogs"],"summary":"Update My Blog Settings (PUT)","description":"Update basic settings like blog name, description, logo, favicon, and featured image using PUT.\n\n**Image Processing:**\nLogo, favicon, and featured image URLs are uploaded to Inblog R2 storage by default.\nTo preserve original URLs, use the `preserve_external_images=true` query parameter.\n","operationId":"replaceMyBlog","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:write"],"parameters":[{"name":"preserve_external_images","in":"query","required":false,"description":"Preserve external image URLs instead of uploading to R2 storage","schema":{"type":"boolean","default":false}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlogUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BlogUpdateRequest"}}}},"responses":{"200":{"description":"Blog updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BlogResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/redirects":{"get":{"tags":["Redirects"],"summary":"List Redirects","description":"Retrieve all URL redirect rules configured for the blog.","operationId":"listRedirects","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["redirects:read"],"parameters":[{"$ref":"#/components/parameters/PageParam"},{"$ref":"#/components/parameters/LimitParam"}],"responses":{"200":{"description":"Redirect list retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"post":{"tags":["Redirects"],"summary":"Create Redirect","description":"Create a new redirect rule.\n**Required Fields:** - from_path: Source path to redirect from - to_path: Target path to redirect to\n**Response Codes:** - 201: Redirect created successfully - 409: from_path already exists\n","operationId":"createRedirect","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["redirects:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedirectCreateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectCreateRequest"}}}},"responses":{"201":{"description":"Redirect created successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"405":{"$ref":"#/components/responses/MethodNotAllowedError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/redirects/{id}":{"get":{"tags":["Redirects"],"summary":"Get Redirect","description":"Retrieve detailed information for a specific redirect rule.","operationId":"getRedirect","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["redirects:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Redirect ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Redirect retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Redirects"],"summary":"Update Redirect","description":"Update a redirect rule.","operationId":"updateRedirect","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["redirects:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Redirect ID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedirectUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectUpdateRequest"}}}},"responses":{"200":{"description":"Redirect updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"put":{"tags":["Redirects"],"summary":"Update Redirect (PUT)","description":"Update a redirect rule using PUT. The current implementation treats PUT and PATCH identically.","operationId":"replaceRedirect","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["redirects:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Redirect ID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedirectUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectUpdateRequest"}}}},"responses":{"200":{"description":"Redirect updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/RedirectResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"409":{"$ref":"#/components/responses/ConflictError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"delete":{"tags":["Redirects"],"summary":"Delete Redirect","description":"Permanently delete a redirect rule. ⚠️ This action cannot be undone!","operationId":"deleteRedirect","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["redirects:write"],"parameters":[{"name":"id","in":"path","required":true,"description":"Redirect ID","schema":{"type":"string"}}],"responses":{"204":{"description":"Redirect deleted successfully"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/forms":{"get":{"tags":["Forms"],"summary":"List Forms","description":"Retrieve a paginated list of forms for the blog. Each form includes its current response count.","operationId":"listForms","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["forms:read"],"parameters":[{"$ref":"#/components/parameters/PageParam"},{"$ref":"#/components/parameters/LimitParam"}],"responses":{"200":{"description":"Forms retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FormListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/forms/{id}":{"get":{"tags":["Forms"],"summary":"Get Form","description":"Retrieve detailed information for a specific form by ID.","operationId":"getForm","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["forms:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Form ID","schema":{"type":"integer","example":123}}],"responses":{"200":{"description":"Form retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FormSingleResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/form-responses":{"get":{"tags":["Form Responses"],"summary":"List Form Responses","description":"Retrieve a paginated list of form responses for the blog. You can filter by form ID, and each response includes relationship identifiers for the related form, post, and blog when available.","operationId":"listFormResponses","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["form_responses:read"],"parameters":[{"$ref":"#/components/parameters/PageParam"},{"$ref":"#/components/parameters/LimitParam"},{"name":"form_id","in":"query","required":false,"description":"Filter responses by form ID","schema":{"type":"integer","example":123}}],"responses":{"200":{"description":"Form responses retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FormResponseListResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/form-responses/{id}":{"get":{"tags":["Form Responses"],"summary":"Get Form Response","description":"Retrieve detailed information for a specific form response by ID.","operationId":"getFormResponse","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["form_responses:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Form Response ID","schema":{"type":"integer","example":123}}],"responses":{"200":{"description":"Form response retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FormResponseSingleResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/domain":{"post":{"tags":["Custom Domain"],"summary":"Add Custom Domain","description":"Add a custom domain to your blog. Returns domain configuration including Vercel DNS settings required for verification.","operationId":"addCustomDomain","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainAddRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/DomainAddJsonApiRequest"}}}},"responses":{"200":{"description":"Custom domain added successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainAddResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"get":{"tags":["Custom Domain"],"summary":"Check Domain Status","description":"Check the current custom domain configuration and DNS verification status.","operationId":"getDomainStatus","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"responses":{"200":{"description":"Domain status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainStatusResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"delete":{"tags":["Custom Domain"],"summary":"Remove Custom Domain","description":"Remove the custom domain from your blog. The blog will revert to the default subdomain.","operationId":"deleteCustomDomain","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:write"],"responses":{"200":{"description":"Custom domain removed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainDeleteResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/custom-ui":{"get":{"tags":["Custom UI"],"summary":"Get Banner & UI Settings","description":"Retrieve the current banner and UI customization settings for your blog.","operationId":"getCustomUi","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"responses":{"200":{"description":"UI settings retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomUiEnvelopeResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Custom UI"],"summary":"Update Banner & UI Settings","description":"Update banner and UI customization settings. Only provided fields will be updated.","operationId":"updateCustomUi","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomUiUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/CustomUiUpdateJsonApiRequest"}}}},"responses":{"200":{"description":"UI settings updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomUiEnvelopeResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/design-code":{"get":{"tags":["Design Code"],"summary":"Get Design Code","description":"Retrieve the custom design code fields for your blog: banner and layout Handlebars templates, custom CSS, and header/footer HTML. Requires editor permission or higher on the blog.","operationId":"getDesignCode","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:code"],"responses":{"200":{"description":"Design code retrieved successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/DesignCodeResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}},"patch":{"tags":["Design Code"],"summary":"Update Design Code","description":"Partially update design code fields. Only provided fields will be updated. Set a field to null to clear it. Requires editor permission or higher on the blog.","operationId":"updateDesignCode","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:code"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignCodeUpdateRequest"}},"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/DesignCodeUpdateRequest"}}}},"responses":{"200":{"description":"Design code updated successfully","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/DesignCodeResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/design-code/validate":{"post":{"tags":["Design Code"],"summary":"Validate Design Code","description":"Validate a design code field without saving it. Handlebars template fields (custom_banner_code, custom_layout_code) are compiled against the registered helper set; syntax errors and unknown helpers are reported with line numbers. The CSS, header, and footer fields always pass. Validation is compile-level only β€” partials and helper calls without arguments can still fail at render time, so check the rendered blog page after saving. Requires editor permission or higher on the blog.","operationId":"validateDesignCode","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:code"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignCodeValidateRequest"}}}},"responses":{"200":{"description":"Validation completed. Check `data.valid` for the result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignCodeValidateResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/search-console/oauth-url":{"get":{"tags":["Search Console"],"summary":"Get Search Console OAuth URL","description":"Get the Google OAuth URL for connecting Search Console. Use the optional redirect_uri parameter for CLI-based authentication flows.","operationId":"getSearchConsoleOAuthUrl","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"redirect_uri","in":"query","required":false,"description":"Custom redirect URI for CLI callback","schema":{"type":"string","format":"uri"}}],"responses":{"200":{"description":"OAuth URL generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthUrlResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/search-console/connect":{"post":{"tags":["Search Console"],"summary":"Connect Search Console","description":"Exchange an OAuth authorization code for tokens to complete the Search Console connection.","operationId":"connectSearchConsole","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchConsoleConnectRequest"}}}},"responses":{"200":{"description":"Search Console connected successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchConsoleConnectResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/search-console/status":{"get":{"tags":["Search Console"],"summary":"Check Search Console Status","description":"Check whether Google Search Console is connected to your blog.","operationId":"getSearchConsoleStatus","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"responses":{"200":{"description":"Connection status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchConsoleStatusResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/search-console/disconnect":{"delete":{"tags":["Search Console"],"summary":"Disconnect Search Console","description":"Disconnect Google Search Console from your blog. Removes stored OAuth tokens.","operationId":"disconnectSearchConsole","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:write"],"responses":{"200":{"description":"Search Console disconnected successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchConsoleDisconnectResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/search-console/keywords":{"get":{"tags":["Search Console"],"summary":"Get Keyword Performance","description":"Get keyword-level search performance data from Google Search Console. Returns clicks, impressions, CTR, and average position for each keyword.","operationId":"getSearchConsoleKeywords","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"start_date","in":"query","required":false,"description":"Start date (YYYY-MM-DD). Defaults to 28 days ago.","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"end_date","in":"query","required":false,"description":"End date (YYYY-MM-DD). Defaults to today.","schema":{"type":"string","format":"date","example":"2025-01-28"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","minimum":1,"maximum":1000,"default":20}},{"name":"sort","in":"query","required":false,"description":"Field to sort results by","schema":{"type":"string","enum":["clicks","impressions","ctr","position"],"default":"clicks"}},{"name":"order","in":"query","required":false,"description":"Sort order","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Keyword performance data retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPerformanceResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/search-console/pages":{"get":{"tags":["Search Console"],"summary":"Get Page Performance","description":"Get page-level search performance data from Google Search Console. Returns clicks, impressions, CTR, and average position for each page.","operationId":"getSearchConsolePages","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"start_date","in":"query","required":false,"description":"Start date (YYYY-MM-DD). Defaults to 28 days ago.","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"end_date","in":"query","required":false,"description":"End date (YYYY-MM-DD). Defaults to today.","schema":{"type":"string","format":"date","example":"2025-01-28"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","minimum":1,"maximum":1000,"default":20}},{"name":"sort","in":"query","required":false,"description":"Field to sort results by","schema":{"type":"string","enum":["clicks","impressions","ctr","position"],"default":"clicks"}},{"name":"order","in":"query","required":false,"description":"Sort order","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Page performance data retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPerformanceResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/analytics/traffic":{"get":{"tags":["Analytics"],"summary":"Get Blog Traffic","description":"Get blog-wide traffic data with daily or hourly granularity. Includes visits, clicks, organic traffic, and page type breakdowns.","operationId":"getBlogTraffic","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"start_date","in":"query","required":false,"description":"Start date (YYYY-MM-DD). Defaults to 28 days ago.","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"end_date","in":"query","required":false,"description":"End date (YYYY-MM-DD). Defaults to today.","schema":{"type":"string","format":"date","example":"2025-01-28"}},{"name":"interval","in":"query","required":false,"description":"Time interval for data aggregation","schema":{"type":"string","enum":["day","hour"],"default":"day"}},{"name":"type","in":"query","required":false,"description":"Filter by page type","schema":{"type":"string","enum":["all","home","post","category","author"],"default":"all"}}],"responses":{"200":{"description":"Traffic data retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrafficResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/analytics/posts":{"get":{"tags":["Analytics"],"summary":"Get Post Performance Metrics","description":"Get per-post performance metrics including visits, clicks, organic traffic, and conversion rate.","operationId":"getPostMetrics","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"start_date","in":"query","required":false,"description":"Start date (YYYY-MM-DD). Defaults to 28 days ago.","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"end_date","in":"query","required":false,"description":"End date (YYYY-MM-DD). Defaults to today.","schema":{"type":"string","format":"date","example":"2025-01-28"}},{"name":"sort","in":"query","required":false,"description":"Field to sort results by","schema":{"type":"string","enum":["visits","clicks","organic","cvr"],"default":"visits"}},{"name":"order","in":"query","required":false,"description":"Sort order","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","minimum":1,"maximum":1000,"default":20}},{"name":"include","in":"query","required":false,"description":"Set to \"title\" to include post titles in the response","schema":{"type":"string","enum":["title"]}}],"responses":{"200":{"description":"Post metrics retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMetricsResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/analytics/sources":{"get":{"tags":["Analytics"],"summary":"Get Traffic Sources","description":"Get traffic source analysis showing referrer data sorted by visit count.","operationId":"getTrafficSources","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"start_date","in":"query","required":false,"description":"Start date (YYYY-MM-DD). Defaults to 28 days ago.","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"end_date","in":"query","required":false,"description":"End date (YYYY-MM-DD). Defaults to today.","schema":{"type":"string","format":"date","example":"2025-01-28"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","minimum":1,"maximum":1000,"default":20}}],"responses":{"200":{"description":"Traffic sources retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferrerResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/analytics/posts/{id}":{"get":{"tags":["Analytics"],"summary":"Get Post Traffic","description":"Get traffic data over time for a specific post with daily or hourly granularity.","operationId":"getPostTraffic","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}},{"name":"start_date","in":"query","required":false,"description":"Start date (YYYY-MM-DD). Defaults to 28 days ago.","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"end_date","in":"query","required":false,"description":"End date (YYYY-MM-DD). Defaults to today.","schema":{"type":"string","format":"date","example":"2025-01-28"}},{"name":"interval","in":"query","required":false,"description":"Time interval for data aggregation","schema":{"type":"string","enum":["day","hour"],"default":"day"}}],"responses":{"200":{"description":"Post traffic data retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTrafficResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}},"/blogs/analytics/posts/{id}/sources":{"get":{"tags":["Analytics"],"summary":"Get Post Traffic Sources","description":"Get traffic source analysis for a specific post showing referrer data.","operationId":"getPostTrafficSources","security":[{"bearerAuth":[]}],"x-inblog-required-scopes":["blogs:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"Post ID","schema":{"type":"integer"}},{"name":"start_date","in":"query","required":false,"description":"Start date (YYYY-MM-DD). Defaults to 28 days ago.","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"end_date","in":"query","required":false,"description":"End date (YYYY-MM-DD). Defaults to today.","schema":{"type":"string","format":"date","example":"2025-01-28"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of results to return","schema":{"type":"integer","minimum":1,"maximum":1000,"default":20}}],"responses":{"200":{"description":"Post traffic sources retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferrerResponse"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use API key as Bearer token.\n\nFormat: `Authorization: Bearer YOUR_API_KEY`\n\nAPI keys can be generated from the Inblog dashboard.\n"},"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Use a signed user JWT as the Bearer token.\n\nFormat: `Authorization: Bearer USER_JWT`\n\nThis scheme is used for user-scoped endpoints such as `/user/blogs`.\n"}},"parameters":{"PageParam":{"name":"page","in":"query","description":"Page number (starting from 1) JSON:API style `page[number]` is also accepted.","schema":{"type":"integer","minimum":1,"default":1,"example":1}},"FieldsPostsParam":{"name":"fields[posts]","in":"query","description":"Comma-separated post fields to return. Unknown names are ignored. Include content_html to request the post body, which is omitted by default.","schema":{"type":"string","example":"title,slug,content_html"}},"LimitParam":{"name":"limit","in":"query","description":"Items per page JSON:API style `page[size]` is also accepted.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10,"example":10}},"IncludeParam":{"name":"include","in":"query","description":"Specify related resources to include, separated by commas\n\nAvailable values for Posts:\n- `tags` - Post tags\n- `authors` - Post authors\n","schema":{"type":"string","example":"tags,authors"}},"FilterSlugParam":{"name":"filter[slug]","in":"query","description":"Filter by slug. Returns only posts with an exact match.","schema":{"type":"string","example":"my-post"}},"FilterPublishedParam":{"name":"filter[published]","in":"query","description":"Filter by published status.","schema":{"type":"boolean","example":true}},"FilterPublishedAtGteParam":{"name":"filter[published_at_gte]","in":"query","description":"Return only posts published on or after this date. (ISO 8601 format)","schema":{"type":"string","format":"date-time","example":"2024-01-01"}},"FilterPublishedAtLteParam":{"name":"filter[published_at_lte]","in":"query","description":"Return only posts published on or before this date. (ISO 8601 format)","schema":{"type":"string","format":"date-time","example":"2024-12-31"}},"FilterTagIdParam":{"name":"filter[tag_id]","in":"query","description":"Return only posts with the specified tag.","schema":{"type":"integer","example":123}},"FilterAuthorIdParam":{"name":"filter[author_id]","in":"query","description":"Return only posts by the specified author.","schema":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"}},"FilterContentTypeParam":{"name":"filter[content_type]","in":"query","description":"Filter by content type.","schema":{"type":"string","enum":["tiptap","notion"],"example":"tiptap"}},"SortParam":{"name":"sort","in":"query","description":"Sort field.","schema":{"type":"string","enum":["published_at","created_at","updated_at","title"],"default":"created_at","example":"published_at"}},"OrderParam":{"name":"order","in":"query","description":"Sort direction.","schema":{"type":"string","enum":["asc","desc"],"default":"desc","example":"desc"}}},"schemas":{"JsonApiVersion":{"type":"object","properties":{"jsonapi":{"type":"object","description":"JSON:API version metadata included in every JSON:API response.","properties":{"version":{"type":"string","description":"Implemented JSON:API version.","default":"1.0","example":"1.0"}},"required":["version"]}},"required":["jsonapi"]},"ResourceIdentifier":{"type":"object","properties":{"type":{"type":"string","description":"Resource type (required)\n- posts, tags, authors etc.\n","example":"tags"},"id":{"type":"string","description":"Resource ID (required)\n- String format\n- Must be unique within its type\n\n**Important:** The example value (123) is a sample. For actual use:\n- Get Tag IDs: `GET /v1/tags`\n- Get Author IDs: `GET /v1/authors`\n\nUsing non-existent IDs will result in a 400 error.\n","example":"123"}},"required":["type","id"]},"Relationship":{"type":"object","properties":{"data":{"description":"Related resource identifier, array of resource identifiers, or `null`.","oneOf":[{"$ref":"#/components/schemas/ResourceIdentifier"},{"type":"array","items":{"$ref":"#/components/schemas/ResourceIdentifier"}},{"type":"object","nullable":true,"enum":[null]}]}}},"Links":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"URL of the current resource"}}},"Meta":{"type":"object","properties":{"total":{"type":"integer","description":"Total number of items"},"page":{"type":"integer","description":"Current page"},"limit":{"type":"integer","description":"Items per page"},"totalPages":{"type":"integer","description":"Total number of pages"}}},"UserBlogResource":{"type":"object","properties":{"type":{"type":"string","description":"Resource type identifier. Always `blogs`.","enum":["blogs"],"example":"blogs"},"id":{"type":"string","description":"Numeric blog ID serialized as a string","example":"123"},"attributes":{"type":"object","description":"Blog attributes visible to the authenticated user.","properties":{"title":{"type":"string","description":"Blog title","example":"My Team Blog"},"subdomain":{"type":"string","description":"Blog subdomain","example":"team-blog"},"plan":{"type":"string","description":"Current subscription plan for the blog","example":"team"},"logo_url":{"type":"string","format":"uri","nullable":true,"description":"Blog logo URL","example":"https://source.inblog.dev/blog-logo.png"},"blog_language":{"type":"string","description":"Primary language configured for the blog","example":"en"},"custom_domain":{"type":"string","nullable":true,"description":"Connected custom domain, if one is configured","example":"blog.example.com"},"created_at":{"type":"string","format":"date-time","description":"Blog creation time (ISO 8601)","example":"2024-01-15T09:30:00Z"},"permission":{"type":"string","description":"Current user's permission on the blog","enum":["owner","editor","author"],"example":"editor"},"can_publish":{"type":"boolean","description":"Whether the current user is allowed to publish posts on this blog","example":true}}}}},"UserBlogListResponse":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"type":"array","description":"Accessible blog resources for the current user.","items":{"$ref":"#/components/schemas/UserBlogResource"}}},"required":["data"]}]},"UploadResponse":{"type":"object","properties":{"publicUrl":{"type":"string","format":"uri","description":"Public URL of the uploaded asset","example":"https://source.inblog.dev/post-image/2026-04-02T10:00:00.000Z-uuid.png"}},"required":["publicUrl"]},"Error":{"type":"object","properties":{"status":{"type":"string","description":"HTTP status code"},"code":{"type":"string","description":"Error code"},"title":{"type":"string","description":"Error title"},"detail":{"type":"string","description":"Detailed error message"}},"required":["status","code","title"]},"ErrorResponse":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"errors":{"type":"array","description":"List of JSON:API error objects.","items":{"$ref":"#/components/schemas/Error"}}},"required":["errors"]}]},"ApiKeyResource":{"type":"object","properties":{"type":{"type":"string","description":"Resource type identifier. Always `api_keys`.","enum":["api_keys"],"example":"api_keys"},"id":{"type":"string","description":"Client ID"},"attributes":{"type":"object","description":"API key attributes and granted scopes.","properties":{"subdomain":{"type":"string","description":"Subdomain of connected blog","example":"myblog"},"blog_id":{"type":"integer","description":"Blog ID","example":123},"scopes":{"type":"array","description":"List of permissions granted to API key","items":{"type":"string","enum":["posts:read","posts:write","posts:delete","tags:read","tags:write","tags:delete","authors:read","authors:write","blogs:read","blogs:write","redirects:read","redirects:write"]},"example":["posts:read","posts:write","tags:read"]}}},"links":{"$ref":"#/components/schemas/Links"}}},"ApiKeyResponse":{"allOf":[{"$ref":"#/components/schemas/JsonApiVersion"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiKeyResource"}},"required":["data"]}]},"PostResource":{"type":"object","properties":{"type":{"type":"string","description":"Resource type identifier\n- Fixed value according to JSON:API standard\n- Always \"posts\"\n","enum":["posts"],"example":"posts"},"id":{"type":"string","description":"Post ID","example":"123"},"attributes":{"type":"object","description":"Primary post fields returned by the API.","properties":{"title":{"type":"string","description":"Post title (recommended under 60 characters for SEO)","maxLength":200,"example":"Building a Blog with Next.js"},"slug":{"type":"string","description":"URL-friendly unique identifier. Only letters, numbers, and hyphens allowed","pattern":"^[a-z0-9-]+$","example":"nextjs-blog-tutorial"},"description":{"type":"string","description":"Post summary description (SEO meta description)","maxLength":160,"example":"Learn how to build a blog using Next.js and TypeScript."},"content_html":{"type":"string","description":"\"Post content HTML (generated with TipTap editor)\n\n**Generation Method:**\n\n- Inblog uses a TipTap-based WYSIWYG editor to generate HTML\n\n- Real-time HTML conversion using editor.getHTML() method\n\n- All content is managed in structured block units\n\n**Basic HTML Tags:**\n\n- Paragraph: `

`\n\n- Headings: `

`, `

`, `

` (h1, h5, h6 not supported)\n\n- Lists: `