Nerdit Projects API
The projects API from Nerdit — 4 operation(s) for projects.
The projects API from Nerdit — 4 operation(s) for projects.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/nerdit-ai:nerdit-ai-projects-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Nerdit Cloud (web) Projects API
version: 0.1.0
tags:
- name: Projects
paths:
/api/projects:
get:
tags:
- Projects
summary: List Projects
operationId: list_projects_api_projects_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 100
title: Limit
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
pattern: ^prj_[a-z2-7]{16}$
- type: 'null'
title: Cursor
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectDirectory'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Projects
summary: Create Project
operationId: create_project_api_projects_post
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectCreate'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectView'
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unauthorized
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Forbidden
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Not Found
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Conflict
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Unprocessable Content
'502':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
description: Bad Gateway
/api/projects/{project_id}:
get:
tags:
- Projects
summary: Get Project
operationId: get_project_api_projects__project_id__get
parameters:
- name: project_id
in: path
required: true
schema:
type: string
minLength: 20
maxLength: 20
pattern: ^prj_[a-z2-7]{16}$
title: Project Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectView'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
patch:
tags:
- Projects
summary: Rename Project
operationId: rename_project_api_projects__project_id__patch
parameters:
- name: project_id
in: path
required: true
schema:
type: string
minLength: 20
maxLength: 20
pattern: ^prj_[a-z2-7]{16}$
title: Project Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectRename'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectView'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/projects/{project_id}/live:
get:
tags:
- Projects
summary: Live Project
operationId: live_project_api_projects__project_id__live_get
parameters:
- name: project_id
in: path
required: true
schema:
type: string
minLength: 20
maxLength: 20
pattern: ^prj_[a-z2-7]{16}$
title: Project Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectLiveView'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/projects/{project_id}/variables:
put:
tags:
- Projects
summary: Set Variables
operationId: set_variables_api_projects__project_id__variables_put
parameters:
- name: project_id
in: path
required: true
schema:
type: string
minLength: 20
maxLength: 20
pattern: ^prj_[a-z2-7]{16}$
title: Project Id
- name: service
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 20
pattern: ^(?!.*--)[a-z0-9]([a-z0-9-]{0,18}[a-z0-9])?$
- type: 'null'
title: Service
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectVariablesSet'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectVariablesResult'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ProjectView:
properties:
id:
type: string
title: Id
name:
type: string
title: Name
node_id:
anyOf:
- type: string
format: uuid
- type: 'null'
title: Node Id
node_name:
anyOf:
- type: string
- type: 'null'
title: Node Name
sync:
$ref: '#/components/schemas/ProjectSyncState'
type: object
required:
- id
- name
- node_id
- node_name
- sync
title: ProjectView
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ProjectLiveView:
properties:
id:
type: string
title: Id
name:
type: string
title: Name
namespace:
anyOf:
- type: string
- type: 'null'
title: Namespace
services:
items:
$ref: '#/components/schemas/NodeServiceView'
type: array
title: Services
resources:
items:
$ref: '#/components/schemas/ProjectResource'
type: array
title: Resources
variables:
anyOf:
- items:
$ref: '#/components/schemas/ProjectVariable'
type: array
- type: 'null'
title: Variables
addresses:
items:
$ref: '#/components/schemas/ProjectAddress'
type: array
title: Addresses
home:
$ref: '#/components/schemas/ProjectHome'
rename_supported:
type: boolean
title: Rename Supported
deploy_into_project_supported:
type: boolean
title: Deploy Into Project Supported
default: false
type: object
required:
- id
- name
- services
- resources
- variables
- addresses
- home
- rename_supported
title: ProjectLiveView
ProjectRename:
properties:
name:
type: string
pattern: ^(?!.*--)[a-z0-9]([a-z0-9-]{0,38}[a-z0-9])?$
title: Name
additionalProperties: false
type: object
required:
- name
title: ProjectRename
NodeServiceView:
properties:
operation:
anyOf:
- $ref: '#/components/schemas/ServiceOperationView'
- type: 'null'
name:
type: string
title: Name
service:
anyOf:
- type: string
- type: 'null'
title: Service
project_id:
anyOf:
- type: string
- type: 'null'
title: Project Id
kind:
anyOf:
- type: string
- type: 'null'
title: Kind
status:
anyOf:
- type: string
- type: 'null'
title: Status
image:
anyOf:
- type: string
- type: 'null'
title: Image
url:
anyOf:
- type: string
- type: 'null'
title: Url
last_deploy_phase:
anyOf:
- type: string
- type: 'null'
title: Last Deploy Phase
last_deploy_action:
anyOf:
- type: string
- type: 'null'
title: Last Deploy Action
source_type:
anyOf:
- type: string
- type: 'null'
title: Source Type
source_repo:
anyOf:
- type: string
- type: 'null'
title: Source Repo
source_ref:
anyOf:
- type: string
- type: 'null'
title: Source Ref
manageable:
type: boolean
title: Manageable
rollback_available:
type: boolean
title: Rollback Available
additionalProperties: false
type: object
required:
- name
- kind
- status
- image
- url
- last_deploy_phase
- last_deploy_action
- source_type
- source_repo
- source_ref
- manageable
- rollback_available
title: NodeServiceView
description: 'One service as the node describes it, with nothing added and nothing kept.
Every field is the daemon''s own, read defensively off its
``ServiceResponse``. What is deliberately *absent* is as load-bearing as
what is here: no logs and no resource numbers (plan §1 defers both, with
reasons), and no owner token — ``manageable`` is a boolean precisely so the
console never learns *whose* a service is (D-NC5).'
ServiceOperationView:
properties:
identity:
anyOf:
- type: string
- type: 'null'
title: Identity
phase:
anyOf:
- type: string
- type: 'null'
title: Phase
action:
anyOf:
- type: string
- type: 'null'
title: Action
started_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Started At
updated_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Updated At
failure:
anyOf:
- type: string
- type: 'null'
title: Failure
additionalProperties: false
type: object
title: ServiceOperationView
description: Dated operation metadata; arbitrary errors and output never enter this view.
ProjectAddress:
properties:
url:
anyOf:
- type: string
- type: 'null'
title: Url
kind:
type: string
enum:
- default
- hosted
- domain
title: Kind
state:
type: string
title: State
access:
anyOf:
- type: string
enum:
- private
- public
- type: 'null'
title: Access
domain:
anyOf:
- type: string
- type: 'null'
title: Domain
cert_state:
anyOf:
- type: string
- type: 'null'
title: Cert State
type: object
required:
- url
- kind
- state
title: ProjectAddress
ProjectDirectory:
properties:
items:
items:
$ref: '#/components/schemas/ProjectView'
type: array
title: Items
next_cursor:
anyOf:
- type: string
- type: 'null'
title: Next Cursor
sources:
items:
$ref: '#/components/schemas/ProjectSource'
type: array
title: Sources
type: object
required:
- items
- next_cursor
- sources
title: ProjectDirectory
ProjectResource:
properties:
service:
type: string
title: Service
type:
type: string
title: Type
binding:
type: string
title: Binding
provider:
anyOf:
- type: string
- type: 'null'
title: Provider
target:
anyOf:
- type: string
- type: 'null'
title: Target
ready:
anyOf:
- type: boolean
- type: 'null'
title: Ready
type: object
required:
- service
- type
- binding
title: ProjectResource
ProjectVariablesSet:
properties:
values:
additionalProperties:
type: string
type: object
maxProperties: 200
minProperties: 1
title: Values
secret:
type: boolean
title: Secret
default: true
additionalProperties: false
type: object
required:
- values
title: ProjectVariablesSet
ProjectVariable:
properties:
key:
type: string
title: Key
scope:
type: string
title: Scope
plain:
type: boolean
title: Plain
type: object
required:
- key
- scope
- plain
title: ProjectVariable
ProjectSyncState:
properties:
status:
type: string
enum:
- pending
- synced
- offline
- unsupported
- failed
title: Status
default: pending
synced_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Synced At
retirement_supported:
type: boolean
title: Retirement Supported
default: false
bindings_delivered:
type: boolean
title: Bindings Delivered
default: false
type: object
title: ProjectSyncState
description: Connection-local discovery status; never a persisted runtime snapshot.
ProjectVariablesResult:
properties:
project_id:
type: string
title: Project Id
scope:
type: string
title: Scope
keys:
items:
type: string
type: array
title: Keys
plain:
type: boolean
title: Plain
type: object
required:
- project_id
- scope
- keys
- plain
title: ProjectVariablesResult
ProjectSource:
properties:
node_id:
type: string
format: uuid
title: Node Id
node_name:
type: string
title: Node Name
sync:
$ref: '#/components/schemas/ProjectSyncState'
type: object
required:
- node_id
- node_name
- sync
title: ProjectSource
ErrorEnvelope:
properties:
error:
$ref: '#/components/schemas/ErrorDetail'
additionalProperties: false
type: object
required:
- error
title: ErrorEnvelope
description: Response model used by all cloud API errors.
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
ErrorDetail:
properties:
code:
$ref: '#/components/schemas/ErrorCode'
message:
type: string
title: Message
status:
type: integer
title: Status
request_id:
anyOf:
- type: string
- type: 'null'
title: Request Id
details:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Details
additionalProperties: false
type: object
required:
- code
- message
- status
title: ErrorDetail
description: The stable body nested under the envelope's ``error`` key.
ErrorCode:
type: string
enum:
- bad_request
- unauthorized
- forbidden
- not_found
- method_not_allowed
- conflict
- validation_failed
- rate_limited
- internal_error
- service_unavailable
- not_implemented
- plan_limit_exceeded
- link_code_invalid
- link_code_expired
- link_code_consumed
- link_code_attempts_exceeded
- link_code_limit_exceeded
- link_code_denied
- link_key_invalid
- preauth_key_limit_exceeded
- node_not_found
- node_already_linked
- node_offline
- machine_waking
- node_revoked
- entitlement_required
- organisation_has_members
- trial_quota_used
- trial_boxes_busy
- trial_archived
- replace.bad_url
- replace.extractor_unavailable
- replace.already_claimed
- csrf_failed
- auth_transaction_invalid
- auth_transaction_expired
- auth_identity_invalid
- auth_identity_deleting
- session_invalid
- session_expired
- navigation_ticket_invalid
- navigation_ticket_expired
- navigation_ticket_consumed
- proxy_session_invalid
- proxy_session_expired
- origin_forbidden
- hosted_private
- hosted_disabled
- visitor_session_required
- custom_domains.pro_required
- custom_domains.limit_reached
- custom_domains.apex_unsupported
- custom_domains.taken
- custom_domains.not_found
- access_revoked
- webhook_signature_invalid
- already_subscribed
- billing_account_missing
- oauth_invalid_request
- oauth_invalid_client
- oauth_invalid_grant
- oauth_unsupported_grant_type
- oauth_invalid_scope
- oauth_access_denied
- oauth_server_error
- oauth_temporarily_unavailable
- oauth_invalid_token
- oauth_insufficient_scope
- protocol_version_unsupported
- node_authentication_failed
- relay_frame_invalid
- relay_destination_invalid
- relay_stream_unknown
- relay_stream_limit_exceeded
- relay_body_too_large
- relay_response_too_large
- relay_bandwidth_exceeded
- relay_backpressure
- relay_draining
- relay_stream_timeout
title: ErrorCode
description: Codes clients may branch on independently of human-readable messages.
ProjectCreate:
properties:
name:
type: string
pattern: ^(?!.*--)[a-z0-9]([a-z0-9-]{0,38}[a-z0-9])?$
title: Name
node_id:
type: string
format: uuid
title: Node Id
additionalProperties: false
type: object
required:
- name
- node_id
title: ProjectCreate
ProjectHome:
properties:
hostname:
anyOf:
- type: string
- type: 'null'
title: Hostname
node_id:
anyOf:
- type: string
- type: 'null'
title: Node Id
type: object
title: ProjectHome