Skip to content
AdVentur.aiAdVentur.aiAdVentur.ai Docs

Thoughts API

Saved thoughts and the drafts made from them.

5 endpoints. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

GET/v1/orgs/{orgId}/thoughts

Bearer tokenMCP tool: list_thoughts

Lists the thoughts, tips and opinions saved for content, newest first. Archived ones are hidden unless asked for.

Path parameters

  • orgIdstring (uuid)required

Query parameters

  • statusstring

    one of active, new, drafted, archived, all

  • pageinteger
  • limitinteger

Responses

200Lists the thoughts, tips and opinions saved for content, newest first. Archived ones are hidden unless asked for.
  • dataobjectrequired
    Fields
    • itemsarray<object>required
      Item fields
      • idstring (uuid)required
      • orgIdstring (uuid)required
      • textstringrequired
      • kindstringrequired

        one of thought, tip, opinion, story, lesson

      • statusstringrequired

        one of new, drafted, archived

      • sourcestring | nullrequired
      • tagsarray<string>required
      • draftGroupIdsarray<string (uuid)>required
      • lastDraftedAtstring | nullrequired
      • createdAtstringrequired
      • updatedAtstringrequired
    • pageintegerrequired
    • limitintegerrequired
    • totalintegerrequired
    • hasMorebooleanrequired
Request
curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/thoughts" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST/v1/orgs/{orgId}/thoughts

Bearer tokenMCP tool: save_thought

Saves a thought, tip or opinion for content. Active thoughts are taken into account whenever posts are generated.

Path parameters

  • orgIdstring (uuid)required

Request body application/json

  • textstringrequired
  • kindstring

    one of thought, tip, opinion, story, lesson

  • sourcestring
  • tagsarray<string>

Responses

201Saves a thought, tip or opinion for content. Active thoughts are taken into account whenever posts are generated.
  • dataobjectrequired
    Fields
    • idstring (uuid)required
    • orgIdstring (uuid)required
    • textstringrequired
    • kindstringrequired

      one of thought, tip, opinion, story, lesson

    • statusstringrequired

      one of new, drafted, archived

    • sourcestring | nullrequired
    • tagsarray<string>required
    • draftGroupIdsarray<string (uuid)>required
    • lastDraftedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
Request
curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/thoughts" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"string"}'

PATCH/v1/orgs/{orgId}/thoughts/{thoughtId}

Bearer tokenMCP tool: update_thought

Edits a saved thought, or archives it so it stops feeding content generation.

Path parameters

  • orgIdstring (uuid)required
  • thoughtIdstring (uuid)required

Request body application/json

  • textstring
  • kindstring

    one of thought, tip, opinion, story, lesson

  • statusstring

    one of new, drafted, archived

  • tagsarray<string>

Responses

200Edits a saved thought, or archives it so it stops feeding content generation.
  • dataobjectrequired
    Fields
    • idstring (uuid)required
    • orgIdstring (uuid)required
    • textstringrequired
    • kindstringrequired

      one of thought, tip, opinion, story, lesson

    • statusstringrequired

      one of new, drafted, archived

    • sourcestring | nullrequired
    • tagsarray<string>required
    • draftGroupIdsarray<string (uuid)>required
    • lastDraftedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
Request
curl -X PATCH "https://api.adventur.ai/v1/orgs/$ORG_ID/thoughts/$THOUGHT_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE/v1/orgs/{orgId}/thoughts/{thoughtId}

Bearer token

Deletes a saved thought. Drafts already made from it are kept.

Path parameters

  • orgIdstring (uuid)required
  • thoughtIdstring (uuid)required

Responses

200Deletes a saved thought. Drafts already made from it are kept.
  • dataobjectrequired
    Fields
    • idstring (uuid)required
    • orgIdstring (uuid)required
    • textstringrequired
    • kindstringrequired

      one of thought, tip, opinion, story, lesson

    • statusstringrequired

      one of new, drafted, archived

    • sourcestring | nullrequired
    • tagsarray<string>required
    • draftGroupIdsarray<string (uuid)>required
    • lastDraftedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
Request
curl -X DELETE "https://api.adventur.ai/v1/orgs/$ORG_ID/thoughts/$THOUGHT_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST/v1/orgs/{orgId}/thoughts/{thoughtId}/drafts

Bearer tokenMCP tool: draft_post_from_thought

Writes X and LinkedIn posts from a saved thought in a proven viral format and the brand voice, optionally with an on-brand image or carousel, and puts them in Review as pending approval. Never schedules or publishes.

Path parameters

  • orgIdstring (uuid)required
  • thoughtIdstring (uuid)required

Request body application/json

  • platformsarray<string>
  • visualstring

    one of none, image, carousel

  • guidancestring
  • aiBackgroundboolean

Responses

200Writes X and LinkedIn posts from a saved thought in a proven viral format and the brand voice, optionally with an on-brand image or carousel, and puts them in Review as pending approval. Never schedules or publishes.
  • dataobjectrequired
    Fields
    • thoughtobjectrequired
      Fields
      • idstring (uuid)required
      • orgIdstring (uuid)required
      • textstringrequired
      • kindstringrequired

        one of thought, tip, opinion, story, lesson

      • statusstringrequired

        one of new, drafted, archived

      • sourcestring | nullrequired
      • tagsarray<string>required
      • draftGroupIdsarray<string (uuid)>required
      • lastDraftedAtstring | nullrequired
      • createdAtstringrequired
      • updatedAtstringrequired
    • groupobjectrequired
      Fields
      • idstring (uuid)required
      • orgIdstring (uuid)required
      • titlestringrequired
      • topicstring | nullrequired
      • objectivestring | nullrequired
      • statusstringrequired

        one of draft, pending_approval, approved, scheduled, canceled

      • timezonestringrequired
      • scheduledForstring | nullrequired
      • approvedBystring (uuid) | nullrequired
      • approvedAtstring | nullrequired
      • createdAtstringrequired
      • updatedAtstringrequired
      • scheduleReasonstring | null
      • tagIdsarray<string (uuid)>
      • approvalsarray<object>
        Item fields
        • idstring (uuid)required
        • levelstringrequired

          one of group, post

        • groupIdstring (uuid)required
        • postIdstring (uuid) | nullrequired
        • approvedByUserIdstring (uuid)required
        • approvedAtstringrequired
        • actionstringrequired

          one of submit_for_approval, approved, reapproved, rejected

      • strategyIdstring (uuid) | null
      • strategyVersioninteger | null
      • pillarIdstring | null
      • priorityIdstring | null
      • contentTypestring | null
      • opportunityIdstring | null
    • postsarray<object>required
      Item fields
      • idstring (uuid)required
      • orgIdstring (uuid)required
      • groupIdstring (uuid)required
      • platformstringrequired

        one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

      • socialAccountIdstring (uuid) | nullrequired
      • statusstringrequired

        one of draft, pending_approval, approved, scheduled, publishing, awaiting_platform, published, failed, canceled

      • scheduledForUtcstring | nullrequired
      • contentTextstringrequired
      • mediaobject | nullrequired
      • platformPayloadobject | nullrequired
      • publishedExternalIdstring | nullrequired
      • publishedUrlstring | nullrequired
      • attemptCountnumberrequired
      • lastAttemptAtstring | nullrequired
      • nextRetryAtstring | nullrequired
      • lastErrorstring | nullrequired
      • idempotencyKeystring | nullrequired
      • createdAtstringrequired
      • updatedAtstringrequired
      • scheduleReasonstring | null
      • approvalsarray<object>
        Item fields
        • idstring (uuid)required
        • levelstringrequired

          one of group, post

        • groupIdstring (uuid)required
        • postIdstring (uuid) | nullrequired
        • approvedByUserIdstring (uuid)required
        • approvedAtstringrequired
        • actionstringrequired

          one of submit_for_approval, approved, reapproved, rejected

    • visualobject | nullrequired
      Fields
      • kindstringrequired

        one of image, carousel

      • imagesarray<object>required
        Item fields
        • assetIdstring (uuid)required
        • urlstring (uri)required
        • contentTypestringrequired
        • sizeBytesintegerrequired
        • widthintegerrequired
        • heightintegerrequired
        • formatstringrequired

          one of square, portrait, landscape, link, story, pin, x_header, linkedin_banner

        • pageinteger
      • documentUrlstring (uri) | nullrequired
    • visualErrorstring | nullrequired
    • providerModelstringrequired
    • creditsUsednumberrequired
    • remainingCreditsnumberrequired
Request
curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/thoughts/$THOUGHT_ID/drafts" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'