Submit organization application

POST /organizations/apply

Submit a new organization registration application. This endpoint creates a new application and grants the submitting user permission to access it.

Required Permissions: Authenticated user (any role)

Business Rules:

  • Organization name must be unique
  • Email format must be valid
  • All required fields must be provided
application/json

Body Required

  • name string Required

    Name of the organization

    Minimum length is 1, maximum length is 100.

  • description string

    Brief description of the organization

    Maximum length is 500.

  • email string(email) Required

    Primary contact email for the organization

    Maximum length is 200.

  • tags array[string]

    Tags related to the organization. If approved, these tags are shown on the organization's public profile. Can be added later as well.

  • website_url string(uri)

    Organization's website URL

    Maximum length is 200.

  • locations string Required

    Primary location(s) of the organization

    Minimum length is 1, maximum length is 100.

Responses

  • 200 application/json

    Application submitted successfully

    Hide response attribute Show response attribute object
    • application_id string(uuid) Required

      External ID of the created application

  • 400
  • 401
  • 409
  • 500
POST /organizations/apply
curl \
 --request POST 'http://api.example.com/organizations/apply' \
 --header "Content-Type: application/json" \
 --data '{"name":"TechCorp Solutions","tags":["AI","Orchestration","Cloud"],"email":"contact@techcorp.com","locations":"San Francisco, CA","description":"Leading AI and cloud orchestration company","website_url":"https://www.techcorp.com"}'
Request examples
{
  "name": "TechCorp Solutions",
  "tags": [
    "AI",
    "Orchestration",
    "Cloud"
  ],
  "email": "contact@techcorp.com",
  "locations": "San Francisco, CA",
  "description": "Leading AI and cloud orchestration company",
  "website_url": "https://www.techcorp.com"
}
{
  "name": "StartupCo",
  "email": "hello@startupco.com",
  "locations": "New York, NY"
}
Response examples (200)
{
  "application_id": "123e4567-e89b-12d3-a456-426614174000"
}