# Refract API

**Canonical:** https://apis.io/apis/refract-social/refract-social-api/  
**Provider:** Refract — https://apis.io/providers/refract-social/  
**Documentation:** https://refract.social/docs/api

Refract API is one of 2 APIs that [Refract](https://apis.io/providers/refract-social/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Refract API as documented publicly: 31 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/networks` | GET /api/v1/networks lists the networks you can post to, and the Refract CLI reads its network short names from it. |
| GET | `/api/v1/workspaces` | GET /api/v1/workspaces |
| POST | `/api/v1/workspaces/kolo-coffee/accounts/wordpress` | POST /api/v1/workspaces/kolo-coffee/accounts/wordpress |
| POST | `/api/v1/workspaces/kolo-coffee/media` | POST /api/v1/workspaces/kolo-coffee/media |
| POST | `/api/v1/workspaces/kolo-coffee/notes` | POST /api/v1/workspaces/kolo-coffee/notes |
| POST | `/api/v1/workspaces/kolo-coffee/posts` | POST /api/v1/workspaces/kolo-coffee/posts |
| POST | `/api/v1/workspaces/kolo-coffee/posts/{post}/accounts/{account}/edit` | POST /api/v1/workspaces/kolo-coffee/posts/{post}/accounts/{account}/edit |
| POST | `/api/v1/workspaces/kolo-coffee/posts/{post}/schedule` | POST /api/v1/workspaces/kolo-coffee/posts/{post}/schedule |
| GET | `/me` | Who the token acts for, its organization and plan, its role or capability, and the AI credits the person can spend |
| DELETE | `/me/token` | Sign out: revokes this OAuth access token and its refresh token (API tokens are revoked in Settings, 403 here) |
| GET | `/networks` | The networks you can post to, with their limits and what Refract can do there |
| GET | `/networks.json` | GET /networks.json is listed among the developer endpoints in the API changelog. |
| POST | `/refract-events` | POST /refract-events |
| GET | `/workspaces` | Workspaces the token can reach |
| GET | `/workspaces/{workspace}` | One workspace |
| GET | `/workspaces/{workspace}/accounts` | Its connected social accounts |
| POST | `/workspaces/{workspace}/accounts/wordpress` | Connect a WordPress site (the Refract plugin) |
| DELETE | `/workspaces/{workspace}/accounts/wordpress/{account}` | Remove a WordPress site |
| POST | `/workspaces/{workspace}/media` | Upload a file, or add one from a link |
| GET | `/workspaces/{workspace}/media/{media}` | One file |
| POST | `/workspaces/{workspace}/notes` | Start a draft from a blog post's note |
| PATCH | `/workspaces/{workspace}/notes/{post}` | Update that note after the blog post changed |
| GET | `/workspaces/{workspace}/posts` | Its posts, newest first |
| POST | `/workspaces/{workspace}/posts` | Create a draft |
| DELETE | `/workspaces/{workspace}/posts/{post}` | Delete it |
| GET | `/workspaces/{workspace}/posts/{post}` | One post |
| POST | `/workspaces/{workspace}/posts/{post}/accounts/{account}/remove` | Remove after publishing |
| POST | `/workspaces/{workspace}/posts/{post}/approve-all` | Approve every version and add the post to the queue, or send it for approval |
| POST | `/workspaces/{workspace}/posts/{post}/schedule` | Schedule it, or send it for approval |
| GET | `/workspaces/{workspace}/posts/{post}/versions` | A post's versions, with their checks and status |
| POST | `/workspaces/{workspace}/posts/{post}/versions/{version}/approve` | Approve one version |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/refract-social/openapi/_ae-authored/refract-social-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/refract-social/json-schema/refract-social-post-api-v1-workspaces-kolo-coffee-notes-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/refract-social/json-schema/refract-social-post-api-v1-workspaces-kolo-coffee-notes-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/refract-social/json-schema/refract-social-post-workspaces-workspace-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/refract-social/json-schema/refract-social-post-api-v1-workspaces-kolo-coffee-media-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/refract-social/json-schema/refract-social-post-api-v1-workspaces-kolo-coffee-posts-post-accounts-account-edit-res-schema.json
- **JSONSchema** — https://artifacts.apis.io/refract-social/json-schema/refract-social-post-workspaces-workspace-accounts-wordpress-request-schema.json

## Other Refract APIs (1)

- [Refract API](https://apis.io/apis/refract-social/refract-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/refract-social/refract-social-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/refract-social/.