List the notes on a developer

GET https://api.vamotalent.ai/v2/developers/{developerId}/notes
Access
Authenticated
contact:read
Cost
Free
Rate limit
120 / minute per account
Quota
None

The notes your account keeps about a developer, by developer id, newest first. They are the notes on your contact for that developer, and contactId names it: use it to add, edit or delete a note. A developer you have not saved answers contactId: null and no notes. It reads only your own notes and looks nobody up.

Path parameters

  • developerId string required

    The developer id, as search, lookup and every developer endpoint return it.

    max 64 chars

Query parameters

  • limit integer default: 50

    How many notes to return, 1 to 100.

    min 1, max 100
  • cursor string

    The `nextCursor` from the page before, to read the next, older page. Omit it for the newest notes.

    max 256 chars

Responses

A page of notes, newest first

  • contactId string | null required

    The contact these notes are on: your account’s record of this developer. Null when you have not saved them, in which case there are no notes.

  • notes array of ContactNote required

    This page of notes, newest first.

    • id string required

      The note id.

    • contactId string required

      The contact the note is about.

    • body string required

      The note text, as written.

    • author NoteAuthor required

      Who wrote a note, or who last edited it.

      • kind string required

        What wrote the note: `member` is a person on the account, `key` is an API key, `tool` is an AI tool a person signed in, and `system` is Vamo.

        memberkeytoolsystem
      • id string | null required

        The id of that member, key or tool connection. Null for `system`.

      • name string | null required

        What to call them: the person’s name for a member, the key’s label for a key, the tool’s name for a tool, and `Vamo` for `system`. Null when no name is held.

    • createdAt string required

      When the note was written, as an ISO 8601 instant.

    • updatedAt string | null required

      When the note was last edited, as an ISO 8601 instant. Null when it was never edited.

    • editedBy object required
      • kind string required

        What wrote the note: `member` is a person on the account, `key` is an API key, `tool` is an AI tool a person signed in, and `system` is Vamo.

        memberkeytoolsystem
      • id string | null required

        The id of that member, key or tool connection. Null for `system`.

      • name string | null required

        What to call them: the person’s name for a member, the key’s label for a key, the tool’s name for a tool, and `Vamo` for `system`. Null when no name is held.

  • nextCursor string | null required

    Pass it back as `cursor` to read the next, older page. Null on the last page. Do not parse or construct it.