Create a plugin
POST/api/v1/plugins
Create a new plugin
Request
- application/json
Body
required
Array [
]
The raw source code of the plugin. This should be an .html
file
contexts
object[]
required
Which contexts the plugin should execute/show up in, e.g. { "type": "GLOBAL" }
Description of the plugin
Whether the plugin is generally available or not
The minimum role required to view the plugin, e.g. VIEWER
, USER
, MANAGER
, OWNER
, or the tag for a custom role. Learn more about each permission in our docs.
Display name of the plugin
The identifier of the proxy to use for requests from this plugin
Unique identifier for the plugin
Responses
- 200
- 400
- 429
Metadata of the created plugin
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
contexts
object[]
required
Which contexts the plugin should execute/show up in, e.g. { "type": "GLOBAL" }
createdBy
object
The creator of the plugin. Null if created via API.
Description of the plugin
Whether the plugin is generally available or not
When the plugin was last updated
The minimum role required to view the plugin, e.g. VIEWER
, USER
, MANAGER
, OWNER
, or the tag for a custom role. Learn more about each permission in our docs.
Display name of the plugin
The identifier of the proxy to use for requests from this plugin
Unique identifier for the plugin
{
"contexts": [
{
"type": "string"
}
],
"createdBy": {
"dateCreated": "2024-07-29T15:51:28.071Z",
"email": "string",
"id": 0,
"name": "string",
"oauthUserId": "string",
"tenantId": 0
},
"description": "string",
"isDraft": true,
"lastUpdated": "2024-07-29T15:51:28.071Z",
"minimumRoleRequired": "string",
"name": "string",
"proxyTag": "string",
"tag": "string"
}
Invalid request
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [INTEGRATION_MISSING
, INTEGRATION_UNREGISTERED
, INTEGRATION_UNSUPPORTED
, INTEGRATION_GRAPHQL_ERROR
, INTEGRATION_BAD_REQUEST
, INTEGRATION_UNAUTHORIZED
, INTEGRATION_FORBIDDEN
, INTEGRATION_NOT_FOUND
, INTEGRATION_UNPROCESSABLE_CONTENT
, INTEGRATION_RATE_LIMITED
, INTEGRATION_INTERNAL_ERROR
, INTEGRATION_NOT_IMPLEMENTED
, INTEGRATION_BAD_GATEWAY
, INTEGRATION_UNAVAILABLE
, INTEGRATION_GATEWAY_TIMEOUT
, INTEGRATION_TIMED_OUT
, INTEGRATION_CACHE_ERROR
, INTEGRATION_UNHANDLED_HTTP_ERROR
, INTEGRATION_UNHANDLED_EXCEPTION
, INTEGRATION_UNEXPECTED_ERROR
, ILLEGAL_ARGUMENT_ERROR
, BAD_REQUEST
, FORBIDDEN
, NOT_FOUND
, REQUEST_TIMEOUT
, CONFLICT
, UNHANDLED_EXCEPTION
, UNCATEGORIZED
, SERVICE_CREATOR
, UNKNOWN_HOST
]
{
"details": "string",
"gatewayHttpStatus": 0,
"httpStatus": 0,
"message": "string",
"requestId": "string",
"type": "INTEGRATION_MISSING"
}
The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.
Response Headers
Retry-After
integer
The number of seconds until the rate limiting resets.
- application/problem+json
- Schema
- Example (from schema)
Schema
The number of seconds until the rate limiting resets.
Possible values: >= 100
and <= 599
, [429
]
{
"detail": "string",
"instance": "string",
"retryAfter": 0,
"status": 429,
"title": "string",
"type": "string"
}