Openwork GitHub API
The GitHub API from Openwork — 11 operation(s) for github.
Operations 11
Documentation
Documentation
https://openworklabs.com/docs
APIReference
https://openworklabs.com/docs/api-reference
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/openwork-github-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Den Admin Git Hub API
description: 'OpenAPI spec for the Den control plane API.
Authentication:
- Use `Authorization: Bearer <session-token>` for user-authenticated routes that require a Den session.
- Use `x-api-key: <den-api-key>` for API-key-authenticated routes that accept organization API keys.
- Public routes like health and documentation do not require authentication.
Swagger tip: use the security schemes in the Authorize dialog to set either `bearerAuth` or `denApiKey` before trying protected endpoints.'
version: dev
servers:
- url: https://api.openworklabs.com
tags:
- name: GitHub
paths:
/v1/connectors/github/install/start:
post:
operationId: postV1ConnectorsGithubInstallStart
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
returnPath:
type: string
minLength: 1
maxLength: 1024
required:
- returnPath
tags:
- GitHub
summary: Start GitHub install
description: Builds a GitHub App install redirect URL for the current organization.
responses:
'200':
description: GitHub install redirect returned successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubInstallStartResponse'
'400':
description: The GitHub install request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to connect GitHub.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'403':
description: The caller lacks permission to connect GitHub.
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
/v1/connectors/github/install/complete:
post:
operationId: postV1ConnectorsGithubInstallComplete
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
installationId:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
state:
type: string
minLength: 1
maxLength: 4096
required:
- installationId
- state
tags:
- GitHub
summary: Complete GitHub install
description: Completes a GitHub App installation for the current organization and returns visible repositories.
responses:
'200':
description: GitHub installation completed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubInstallCompleteResponse'
'400':
description: The GitHub install completion request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to complete GitHub connection.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'403':
description: The caller lacks permission to complete GitHub connection.
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
/v1/plugins/import-mcps-from-github-url/preview:
post:
operationId: postV1PluginsImportMcpsFromGithubUrlPreview
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
githubUrl:
type: string
maxLength: 2048
format: uri
required:
- githubUrl
tags:
- GitHub
summary: Preview GitHub plugin marketplace import
description: Reads a public GitHub plugin URL and returns skills and remote MCP servers that can be imported into an organization marketplace.
responses:
'200':
description: GitHub plugin MCP import preview returned successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/GithubPluginMcpImportPreviewResponse'
'400':
description: The GitHub plugin MCP import preview request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to preview plugin MCP imports.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'404':
description: The GitHub plugin path could not be found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
/v1/plugins/import-mcps-from-github-url:
post:
operationId: postV1PluginsImportMcpsFromGithubUrl
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
githubUrl:
type: string
maxLength: 2048
format: uri
access:
type: object
properties:
orgWide:
default: true
type: boolean
memberIds:
maxItems: 200
type: array
items:
description: Den TypeID with 'om_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 29
maxLength: 29
pattern: ^om_.*
teamIds:
maxItems: 200
type: array
items:
description: Den TypeID with 'tem_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^tem_.*
authType:
default: oauth
type: string
enum:
- oauth
- none
credentialMode:
default: per_member
type: string
enum:
- shared
- per_member
description:
anyOf:
- type: string
maxLength: 65535
- type: 'null'
marketplaceId:
description: Den TypeID with 'mkt_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^mkt_.*
name:
type: string
minLength: 1
maxLength: 255
selectedSkillKeys:
maxItems: 200
type: array
items:
type: string
minLength: 1
maxLength: 1024
selectedServerKeys:
maxItems: 200
type: array
items:
type: string
minLength: 1
maxLength: 1024
selectedServerNames:
maxItems: 200
type: array
items:
type: string
minLength: 1
maxLength: 255
required:
- githubUrl
tags:
- GitHub
summary: Create a plugin from GitHub
description: Creates one plugin from selected skills and remote MCP servers in a public GitHub plugin URL, applies the requested access grants, and optionally publishes it into an organization marketplace. Declared and known-server authentication requirements take precedence over the request-wide auth fallback.
responses:
'200':
description: GitHub plugin MCPs imported successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/GithubPluginMcpImportResponse'
'400':
description: The GitHub plugin MCP import request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to import plugin MCPs.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'403':
description: The caller lacks permission to import plugin MCPs.
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
'404':
description: The GitHub plugin path or marketplace could not be found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
/v1/connector-instances/{connectorInstanceId}/discovery:
get:
operationId: getV1ConnectorInstancesByConnectorInstanceIdDiscovery
parameters:
- in: path
name: connectorInstanceId
schema:
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^cin_.*
required: true
description: Den TypeID with 'cin_' prefix and a 26-character base32 suffix.
tags:
- GitHub
summary: Get GitHub connector discovery
description: Analyzes a GitHub connector target and returns discovered plugin candidates.
responses:
'200':
description: GitHub connector discovery returned successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubConnectorDiscoveryResponse'
'400':
description: The connector instance path parameters were invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to inspect GitHub discovery.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'404':
description: The connector instance could not be found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
/v1/connector-instances/{connectorInstanceId}/discovery/tree:
get:
operationId: getV1ConnectorInstancesByConnectorInstanceIdDiscoveryTree
parameters:
- in: path
name: connectorInstanceId
schema:
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^cin_.*
required: true
description: Den TypeID with 'cin_' prefix and a 26-character base32 suffix.
- in: query
name: cursor
schema:
type: string
minLength: 1
maxLength: 255
- in: query
name: limit
schema:
type: integer
exclusiveMinimum: 0
maximum: 500
- in: query
name: prefix
schema:
type: string
minLength: 1
maxLength: 1024
tags:
- GitHub
summary: List GitHub discovery tree entries
description: Pages through the normalized GitHub repository tree used during discovery.
responses:
'200':
description: GitHub discovery tree returned successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubDiscoveryTreeResponse'
'400':
description: The discovery tree request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to inspect GitHub discovery tree entries.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'404':
description: The connector instance could not be found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
/v1/connector-instances/{connectorInstanceId}/discovery/apply:
post:
operationId: postV1ConnectorInstancesByConnectorInstanceIdDiscoveryApply
parameters:
- in: path
name: connectorInstanceId
schema:
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^cin_.*
required: true
description: Den TypeID with 'cin_' prefix and a 26-character base32 suffix.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
autoImportNewPlugins:
default: false
type: boolean
selectedKeys:
maxItems: 200
type: array
items:
type: string
minLength: 1
maxLength: 255
required:
- selectedKeys
tags:
- GitHub
summary: Apply GitHub discovery selection
description: Creates OpenWork plugins and connector mappings from selected discovery candidates.
responses:
'200':
description: GitHub discovery selection applied successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubDiscoveryApplyResponse'
'400':
description: The discovery apply request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to apply discovery selections.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'403':
description: The caller lacks permission to edit this connector instance.
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
'404':
description: The connector instance could not be found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
/v1/connectors/github/accounts:
post:
operationId: postV1ConnectorsGithubAccounts
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
installationId:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
accountLogin:
type: string
minLength: 1
maxLength: 255
accountType:
type: string
enum:
- Organization
- User
displayName:
type: string
minLength: 1
maxLength: 255
required:
- installationId
- accountLogin
- accountType
- displayName
tags:
- GitHub
summary: Create GitHub connector account
description: Persists one GitHub App installation as a connector account.
responses:
'201':
description: GitHub connector account created successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchConnectorAccountMutationResponse'
'400':
description: The GitHub account creation request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to create GitHub connector accounts.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'403':
description: The caller lacks permission to create GitHub connector accounts.
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
/v1/connectors/github/setup:
post:
operationId: postV1ConnectorsGithubSetup
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
installationId:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
connectorAccountId:
description: Den TypeID with 'cac_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^cac_.*
connectorInstanceName:
type: string
minLength: 1
maxLength: 255
repositoryId:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
repositoryFullName:
type: string
minLength: 1
maxLength: 255
branch:
type: string
minLength: 1
maxLength: 255
ref:
type: string
minLength: 1
maxLength: 255
mappings:
maxItems: 100
type: array
items:
type: object
properties:
mappingKind:
type: string
enum:
- path
- api
- custom
selector:
type: string
minLength: 1
maxLength: 255
objectType:
type: string
enum:
- skill
- agent
- command
- tool
- mcp
- hook
- context
- custom
pluginId:
anyOf:
- description: Den TypeID with 'plg_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^plg_.*
- type: 'null'
autoAddToPlugin:
default: false
type: boolean
config:
type: object
properties: {}
additionalProperties: {}
required:
- mappingKind
- selector
- objectType
required:
- installationId
- connectorInstanceName
- repositoryId
- repositoryFullName
- branch
- ref
tags:
- GitHub
summary: Setup GitHub connector
description: Creates a GitHub connector account, instance, target, and initial mappings in one flow.
responses:
'201':
description: GitHub connector setup created successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubSetupResponse'
'400':
description: The GitHub setup request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to setup GitHub connectors.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'403':
description: The caller lacks permission to setup GitHub connectors.
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
/v1/connectors/github/accounts/{connectorAccountId}/repositories:
get:
operationId: getV1ConnectorsGithubAccountsByConnectorAccountIdRepositories
parameters:
- in: path
name: connectorAccountId
schema:
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^cac_.*
required: true
description: Den TypeID with 'cac_' prefix and a 26-character base32 suffix.
- in: query
name: cursor
schema:
type: string
minLength: 1
maxLength: 255
- in: query
name: limit
schema:
type: integer
minimum: 1
maximum: 100
- in: query
name: q
schema:
type: string
minLength: 1
maxLength: 255
tags:
- GitHub
summary: List GitHub repositories
description: Lists repositories visible to one GitHub connector account.
responses:
'200':
description: GitHub repositories returned successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubRepositoryListResponse'
'400':
description: The GitHub repository query parameters were invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to list GitHub repositories.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'404':
description: The connector account could not be found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
/v1/connectors/github/validate-target:
post:
operationId: postV1ConnectorsGithubValidateTarget
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
installationId:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
repositoryId:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
repositoryFullName:
type: string
minLength: 1
maxLength: 255
branch:
type: string
minLength: 1
maxLength: 255
ref:
type: string
minLength: 1
maxLength: 255
required:
- installationId
- repositoryId
- repositoryFullName
- branch
- ref
tags:
- GitHub
summary: Validate GitHub target
description: Validates one repository-branch target before persisting it.
responses:
'200':
description: GitHub target validated successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/PluginArchGithubValidateTargetResponse'
'400':
description: The GitHub target validation request was invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidRequestError'
'401':
description: The caller must be signed in to validate GitHub targets.
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
components:
schemas:
PluginArchGithubRepository:
type: object
properties:
id:
type: integer
exclusiveMinimum: 0
maximum: 9007199254740991
fullName:
type: string
minLength: 1
defaultBranch:
anyOf:
- type: string
minLength: 1
- type: 'null'
hasPluginManifest:
type: boolean
manifestKind:
anyOf:
- type: string
enum:
- marketplace
- plugin
- type: 'null'
marketplacePluginCount:
anyOf:
- type: integer
minimum: 0
maximum: 9007199254740991
- type: 'null'
private:
type: boolean
required:
- id
- fullName
- defaultBranch
- private
PluginArchGithubDiscoveryTreeSummary:
type: object
properties:
scannedEntryCount:
type: integer
minimum: 0
maximum: 9007199254740991
strategy:
type: string
enum:
- git-tree-recursive
truncated:
type: boolean
required:
- scannedEntryCount
- strategy
- truncated
GithubPluginMcpImportPlan:
type: object
properties:
branch:
type: string
classification:
type: string
enum:
- claude_marketplace_repo
- claude_multi_plugin_repo
- claude_single_plugin_repo
- folder_inferred_repo
- unsupported
marketplace:
anyOf:
- type: object
properties:
description:
anyOf:
- type: string
- type: 'null'
name:
anyOf:
- type: string
- type: 'null'
owner:
anyOf:
- type: string
- type: 'null'
version:
anyOf:
- type: string
- type: 'null'
required:
- description
- name
- owner
- version
- type: 'null'
plugins:
type: array
items:
type: object
properties:
description:
anyOf:
- type: string
- type: 'null'
key:
type: string
mcpCount:
type: integer
minimum: 0
maximum: 9007199254740991
name:
type: string
skillCount:
type: integer
minimum: 0
maximum: 9007199254740991
required:
- description
- key
- mcpCount
- name
- skillCount
repositoryFullName:
type: string
rootPath:
type: string
servers:
type: array
items:
$ref: '#/components/schemas/GithubPluginMcpImportServer'
skills:
type: array
items:
type: object
properties:
description:
anyOf:
- type: string
- type: 'null'
name:
type: string
pluginKey:
type: string
pluginName:
type: string
skillKey:
type: string
skippedReason:
anyOf:
- type: string
enum:
- invalid_skill
- type: 'null'
sourcePath:
type: string
supported:
type: boolean
required:
- description
- name
- pluginKey
- pluginName
- skillKey
- skippedReason
- sourcePath
- supported
sourceRevisionRef:
type: string
warnings:
type: array
items:
type: string
required:
- branch
- classification
- marketplace
- plugins
- repositoryFullName
- rootPath
- servers
- skills
- sourceRevisionRef
- warnings
InvalidRequestError:
type: object
properties:
error:
type: string
const: invalid_request
details:
type: array
items:
type: object
properties:
message:
type: string
path:
type: array
items:
anyOf:
- type: string
- type: number
required:
- message
additionalProperties: {}
required:
- error
- details
PluginArchExtensionProjection:
type: object
properties:
id:
description: Den TypeID with 'plg_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^plg_.*
name:
type: string
minLength: 1
maxLength: 255
description:
anyOf:
- type: string
minLength: 1
- type: 'null'
sourceFormat:
type: string
enum:
- openwork-builtin
- openwork-extension-manifest
- claude-plugin
- opencode-plugin
- mcp-directory
- manual
manifest:
anyOf:
- $ref: '#/components/schemas/OpenWorkExtensionManifest'
- type: 'null'
required:
- id
- name
- description
- sourceFormat
- manifest
PluginArchConnectorTarget:
type: object
properties:
id:
description: Den TypeID with 'ctg_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^ctg_.*
connectorInstanceId:
description: Den TypeID with 'cin_' prefix and a 26-character base32 suffix.
format: typeid
type: string
minLength: 30
maxLength: 30
pattern: ^cin_.*
connectorType:
type: string
enum:
- github
remoteId:
type: string
minLength: 1
maxLength: 255
# --- truncated at 32 KB (70 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openwork/refs/heads/main/openapi/openwork-github-api-openapi.yml