API reference

Dev.to

1 endpoint, served at https://orbitwrite.com/api/v1. Each one lists the credentials it accepts, its parameters and every response it can give.

Endpoints
POST/api/v1/integrations/devto/channels

Connect a Dev.to account as a posting channel#

POST/api/v1/integrations/devto/channels

Adds a Dev.to account to the workspace's channels, so articles can be published to it. Dev.to has no OAuth flow: the person generates an API key on Dev.to (Settings → Extensions → DEV Community API Keys) and this call takes it. The key is checked against Dev.to, the account it belongs to becomes the channel, and the key is stored encrypted as that channel's credential — it is never returned by any read. A key Dev.to refuses is a 400. Requires account:connect.

Authentication

An API key or OAuth access token as a bearer token, or a signed-in session.

Query parameters

organizationIdstring

Session callers only — an API key already determines the workspace.

At least 1 character.

Body application/json

apiKeystringRequired

A Dev.to API key, generated on Dev.to under Settings → Extensions → DEV Community API Keys. The account it belongs to becomes the channel; the key is stored encrypted and never returned.

Between 8 and 256 characters.

Responses

200ConnectDevtoChannelResult

The account is connected

Response attributes
channelConnectedDevtoChannelRequired
Child attributes
idstringRequired
displayHandlestringRequired

The Dev.to username.

namestringRequired
createdbooleanRequired
restoredbooleanRequired
becamePrimarybooleanRequired
400Error

Invalid request

Response attributes
errorstringRequired
issuesany[]
401Error

Not signed in

Response attributes
errorstringRequired
issuesany[]
403Error

Not a member of the organization

Response attributes
errorstringRequired
issuesany[]
404Error

The resource does not exist

Response attributes
errorstringRequired
issuesany[]
429Error

Rate limit exceeded

Response attributes
errorstringRequired
issuesany[]
502Error

Dev.to unreachable while checking the key

Response attributes
errorstringRequired
issuesany[]
POST /api/v1/integrations/devto/channels
curl -X POST "https://orbitwrite.com/api/v1/integrations/devto/channels" \
  -H "Authorization: Bearer $ORBITWRITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "apiKey": "string"
}'
Response
{
  "channel": {
    "id": "string",
    "displayHandle": "string",
    "name": "string",
    "created": true,
    "restored": true,
    "becamePrimary": true
  }
}