Discovery (Nexium) API

Build discovery profiles, manage squads, post opportunities, and collaborate via the Emberly Nexium API.

Nexium is Emberly's team collaboration and talent discovery layer. The Discovery API lets you manage your public profile, skills, portfolio signals, squads, opportunities, and applications.

All Discovery endpoints require a session cookie (authenticated browser session). Squad file uploads use a squad upload token — see Squad Tokens.

Overview

Resource	Description
Profile	Your public Nexium profile (bio, skills, signals)
Skills	Technology/skill tags on your profile
Signals	Portfolio links and GitHub repos
Squads	Teams with shared storage, roles, and workspaces
Opportunities	Job posts, bounties, and project requests
Applications	Apply to opportunities
Invites	Squad membership invitations

Discovery Profile

`GET /api/discovery/profile`

Get your own Nexium discovery profile.

Response (200):

{
  "success": true,
  "data": {
    "id": "disc_123",
    "username": "janedoe",
    "bio": "Full-stack developer building cool things.",
    "lookingFor": "freelance",
    "available": true,
    "skills": [
      { "id": "sk_1", "name": "TypeScript", "level": "expert", "order": 0 }
    ],
    "signals": [
      {
        "id": "sig_1",
        "type": "github",
        "url": "https://github.com/EmberlyOSS/Emberly",
        "title": "Emberly",
        "description": "Open-source file hosting platform"
      }
    ],
    "createdAt": "2025-09-01T00:00:00Z"
  }
}

`POST /api/discovery/profile`

Create your discovery profile.

Request Body:

{
  "username": "janedoe",
  "bio": "Full-stack developer.",
  "lookingFor": "freelance",
  "available": true
}

`PUT /api/discovery/profile`

Update your discovery profile.

Request Body (all optional):

{
  "bio": "Updated bio",
  "lookingFor": "fulltime",
  "available": false
}

`DELETE /api/discovery/profile`

Delete your discovery profile (removes it from public search).

`GET /api/discovery/profile/[username]`

Public profile lookup by username. No authentication required.

Response (200):

{
  "success": true,
  "data": {
    "username": "janedoe",
    "bio": "Full-stack developer.",
    "available": true,
    "skills": [ { "name": "TypeScript", "level": "expert" } ],
    "signals": [ { "type": "github", "url": "...", "title": "Emberly" } ]
  }
}

Skills

`GET /api/discovery/skills`

List your skills.

`POST /api/discovery/skills`

Add a skill, bulk-replace all skills, or reorder existing skills.

Add a skill:

{ "name": "Rust", "level": "intermediate" }

Bulk replace:

{
  "skills": [
    { "name": "TypeScript", "level": "expert" },
    { "name": "Rust", "level": "intermediate" }
  ]
}

Reorder:

{ "orderedIds": ["sk_2", "sk_1", "sk_3"] }

`DELETE /api/discovery/skills/[id]`

Remove a specific skill from your profile.

Signals

Signals are portfolio entries — GitHub repositories, live URLs, YouTube videos, etc.

`GET /api/discovery/signals`

List your portfolio signals.

`POST /api/discovery/signals`

Add a signal or reorder existing ones. GitHub URLs are automatically validated via the GitHub API.

Add a signal:

{
  "type": "github",
  "url": "https://github.com/EmberlyOSS/Emberly",
  "title": "Emberly",
  "description": "Open-source file hosting"
}

Reorder:

{ "orderedIds": ["sig_3", "sig_1", "sig_2"] }

`DELETE /api/discovery/signals/[id]`

Remove a specific signal.

`GET /api/discovery/repos`

List GitHub repositories from your linked GitHub account (OAuth token required — link GitHub under Settings → Linked Accounts).

Response (200):

{
  "success": true,
  "data": [
    {
      "id": 123456789,
      "name": "my-project",
      "fullName": "janedoe/my-project",
      "description": "A cool project",
      "url": "https://github.com/janedoe/my-project",
      "stars": 42,
      "language": "TypeScript",
      "updatedAt": "2026-03-01T00:00:00Z"
    }
  ]
}

Opportunities

Opportunities are public listings for jobs, bounties, freelance work, or open-source projects.

`GET /api/discovery/opportunities`

List open opportunities.

Query Parameters:

type — Filter by job, bounty, freelance, opensource
skill — Filter by required skill name
mine=true — List only opportunities you posted (requires auth)

Response (200):

{
  "success": true,
  "data": [
    {
      "id": "opp_123",
      "title": "Frontend Developer",
      "type": "job",
      "description": "Join our team...",
      "requiredSkills": ["React", "TypeScript"],
      "postedBy": { "username": "acme-corp" },
      "createdAt": "2026-04-01T00:00:00Z"
    }
  ]
}

`POST /api/discovery/opportunities`

Create a new opportunity (requires a Discovery profile).

Request Body:

{
  "title": "TypeScript Developer",
  "type": "freelance",
  "description": "Looking for help with our API integration.",
  "requiredSkills": ["TypeScript", "Node.js"],
  "budget": "$500–$1000",
  "contactEmail": "[email protected]"
}

{
  "message": "I'd love to help with this project...",
  "portfolioUrl": "https://janedoe.dev"
}

Response (201):

{
  "success": true,
  "data": { "id": "app_456", "status": "pending" }
}

skill — Filter by skill
status — Filter by status
mine=true — List only squads you are a member of

`POST /api/discovery/squads`

Create a new squad.

Request Body:

{
  "name": "Design Collective",
  "description": "A group of designers sharing assets.",
  "isPublic": true
}

Response (201):

{
  "success": true,
  "data": {
    "id": "squad_789",
    "name": "Design Collective",
    "slug": "design-collective",
    "ownerId": "user_123",
    "createdAt": "2026-04-12T00:00:00Z"
  }
}

{
  "success": true,
  "data": [
    {
      "userId": "user_123",
      "name": "Jane Doe",
      "role": "OWNER",
      "joinedAt": "2026-04-01T00:00:00Z"
    },
    {
      "userId": "user_456",
      "name": "Bob Smith",
      "role": "EDITOR",
      "joinedAt": "2026-04-05T00:00:00Z"
    }
  ]
}

`POST /api/discovery/squads/[id]/members`

Join a squad, add a member, kick a member, or change a member's role.

Join a public squad:

{ "action": "join" }

Add a member (owner):

{ "action": "add", "userId": "user_456", "role": "EDITOR" }

Kick a member (owner):

{ "action": "kick", "userId": "user_456" }

Change role (owner):

{ "action": "setRole", "userId": "user_456", "role": "ADMIN" }

Available roles: OWNER, ADMIN, EDITOR, VIEWER

{ "userId": "user_789" }

{
  "success": true,
  "data": {
    "id": "key_123",
    "key": "esk_live_...",
    "prefix": "esk_live_xxxx",
    "createdAt": "2026-04-12T00:00:00Z"
  }
}

Copy the API key immediately — it is shown only once and cannot be retrieved afterward.

{
  "success": true,
  "data": {
    "storageUsed": 1073741824,
    "storageQuota": 5368709120,
    "plan": "Discovery Pro"
  }
}

{ "domain": "files.myteam.com" }

Teams & Squads User Guide
Files API — personal file uploads
Domains API — custom domain management

On this page