---
title: "Submit an API"
method: POST
path: "/submit"
tags: ["Submit"]
---

# Submit an API

`POST /submit`

## Request

- Base URL: `http://localhost:4000`
- URL: `http://localhost:4000/submit`
- Auth: none declared

Submit a new API for review. Creates a pending submission. Returns 200 with status `approved` if the link was already submitted and approved.

## Request body

- union: Submit an API for review. Provide at least 'name' or 'link'.
  - object
    - `name` string, required: API name
    - `link` string, uri: API URL
  - object
    - `name` string: API name
    - `link` string, uri, required: API URL

## Response `200`

Duplicate link — already submitted and approved

- SubmitApiResponse
  - `success` boolean
  - `message` string
  - `submissionId` string: Public submission ID
  - `status` 'pending' | 'approved'

## Other responses

- `201`: Submission created
- `400`: Validation error

---

[API](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api.md) · [All operations](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/revisions/7f07b9ca718f?raw)