Skip to content
Levr API Documentation
Download OpenAPI specOpenAPI

Hand off to an AI agent

Copy instructions to your AI agent

Copy this guide into your AI agent. It links to the current REST API and MCP documentation.

You are helping someone integrate their system with Levr. Use Levr's published documentation and machine-readable contracts as the source of truth. Do not invent endpoints, fields, or MCP tools.

  1. Start with the Levr API documentation to choose between a server-to-server REST integration and a user-authorized MCP connection.
  2. For REST, read the Markdown REST API guide, choose the user’s task, then fetch only the relevant resource guide and operation Markdown. Resource indexes include task guidance. For funding recommendations, start with the Matchmaking guide. Use the OpenAPI specification for exact paths, authentication, parameters, and envelope schemas.
  3. For REST client intake, Deal applications, or project Criteria, fetch that resource's contract_url. Its Application Contract is the authority for the current questions, stable keys, repeatable groups, file-transfer steps, accepted answer shapes, conditional visibility, supported operation URLs, and integration instructions. Repeatable fields require the returned item_id. File bytes use the expiring upload_url and multipart field named file; they never belong in JSON. Do not substitute a static example or the latest application definition.
  4. For an AI client acting with a signed-in user's access, read the MCP connection instructions in Markdown first, then the Model Context Protocol guide if needed. Let the connected MCP server expose its current tools and input contracts; do not infer tools from the REST API. Read the relevant MCP resource guide and follow the discovered tool’s revision, file-transfer, and confirmation requirements.
  5. Use URLs from the record handoff when supplied; otherwise use this documentation environment. Keep API keys and file-transfer credentials out of browser code, logs, prompts, and source control.
  6. Before implementing a write, verify authentication, required inputs, idempotency, error responses, and retry guidance in the current contract. If an operation is not documented, do not assume it exists.

Early access

Request an integration

Tell us what your integration needs to do. Add an email if you want a reply.

Projects

Request an answer-file upload

Read as Markdown

POST/projects/{project_id}/matchmaking-application/answers/files/

Request a one-hour upload capability for a file question. For a file inside a repeatable group, include that group's item_id.

Parameters

NameLocationTypeRequired
project_id
View parameter schema
pathstringYes

Request body

Send a body that matches the published schema.

View request schema

Example request

cURL
curl --request POST \
  --url "https://api.levr.ai/v1/projects/$PROJECT_ID/matchmaking-application/answers/files/" \
  --header "Authorization: Bearer $LEVR_API_KEY" \
  --header "Content-Type: application/json" \
  --data "@request.json"

Responses

StatusWhat it means
201

Successful response.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
400

Correct the request fields and try again.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
401

Provide a valid API key and try again.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
403

This API key does not allow the requested action.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
404

The requested resource was not found or is not available to this API key.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
409

The request conflicts with the resource's current state. Refresh it before trying again.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
412

The request was not completed.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
413

The request was not completed.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
429

Too many requests were sent. Wait before trying again.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response
500

Levr could not complete the request. Keep the request ID and retry when safe.

View response headers

application/json

View response schema

Illustrative data. Use the identifiers, cursors, and URLs returned by your requests.

View example response