Skip to main content
PATCH
/
companies
/
{id}
Update a company
curl --request PATCH \
  --url https://www.useroulette.com/api/v1/companies/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Acme Corp (Updated)",
  "company_status_id": "status-uuid-here",
  "metadata": {
    "user_preferences": [
      {
        "type": "select",
        "field": "Industry",
        "value": "AI/ML",
        "options": [
          "SaaS",
          "Fintech",
          "AI/ML",
          "Developer Tools"
        ],
        "show_in_table": true
      }
    ]
  }
}'
{
  "success": true,
  "data": {
    "company": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "account_id": "11111111-2222-3333-4444-555555555555",
      "name": "Acme Technologies",
      "deck_link": "https://docsend.com/view/example123",
      "deck_storage_path": "companies/7c9e6679/deck.pdf",
      "visibility": "team",
      "source": "form",
      "source_content": "0: {\"key\":\"question_wbB2ze\",\"type\":\"INPUT_EMAIL\",\"label\":\"Email\",\"value\":\"founder@company.com\"}",
      "notes": "Met at TechCrunch Disrupt. Strong technical team.",
      "company_status_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "company_status": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "status_text": "Initial Review",
        "color": "#3B82F6",
        "rank": 123
      },
      "metadata": {
        "founders": [
          {
            "name": "Jane Smith",
            "email": "jane@example.com",
            "phone": "+1-555-123-4567",
            "title": "CEO/Co-Founder",
            "background": "Former engineer at Google, 10 years in enterprise software",
            "linkedin_profile": "https://www.linkedin.com/in/example/"
          }
        ],
        "ai_analysis": "B2B SaaS platform providing enterprise workflow automation with AI-powered document processing.",
        "analyzed_at": "2024-01-15T12:45:00Z",
        "user_preferences": [
          {
            "type": "select",
            "field": "Industry",
            "value": "AI/ML",
            "options": [
              "SaaS",
              "Fintech",
              "AI/ML",
              "Developer Tools"
            ],
            "show_in_table": true
          }
        ]
      },
      "metadata_search_text": "<string>",
      "assignees": [],
      "created_by": "user-uuid-1234",
      "updated_by": "user-uuid-1234",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T12:45:00Z"
    },
    "pdf_download_url": "<string>"
  },
  "authType": "api_key"
}

Authorizations

Authorization
string
header
required

Path Parameters

id
string<uuid>
required

Body

application/json
name
string
Maximum length: 255
notes
string | null
company_status_id
string<uuid> | null
visibility
enum<string>
Available options:
private,
shared,
team
source
enum<string>
Available options:
manual,
email,
form,
referral,
website,
event,
other
metadata
object

Response

success
boolean
required
Example:
data
object
required
authType
enum<string>
Available options:
api_key,
session