Skip to main content

Story Agent — Activation code expired

You generated an activation code (APRT-XXXX-XXXX) from the aprity managed app's Connectors tab to link a tracker (Jira Cloud, Azure DevOps, Slack), and either :

  • You did not paste it into the tracker within 30 minutes, or
  • The tracker panel reports "code expired" even though the code looks recent.

Why this happens

Activation codes for tracker integrations are short-lived by design :

  • Validity window : 30 minutes from the moment you click Generate.
  • Single use : once redeemed on the tracker side, the code is invalidated. You cannot redeem the same code twice (this is what prevents code leaks from authorizing two different trackers).
  • Tenant-scoped : the code authorizes a specific aprity tenant. Codes generated on one tenant cannot be redeemed on another.

If you generated the code in advance ("for tomorrow's setup session"), or copied it into a chat / email that delayed the paste, the 30-minute window may have elapsed.

Fix

Generate a fresh code -- there is no concept of extending an existing code.

Jira Cloud

  1. Open Salesforce and navigate to the aprity app.
  2. Go to the Connectors tab.
  3. Locate the Jira Cloud card and click Generate New Code.
  4. A fresh code appears in the format APRT-XXXX-XXXX. Use it within 30 minutes.
  5. Continue with Jira Cloud — Story Agent setup from Step 3 (paste the code into Aprity Configuration).

Azure DevOps

  1. Open Salesforce and navigate to the aprity app.
  2. Go to the Connectors tab.
  3. Locate the Azure DevOps card and click Generate New Code.
  4. A fresh code appears in the format APRT-XXXX-XXXX. Use it within 30 minutes.
  5. Continue with Azure DevOps — Story Agent setup from the Paste the activation code step.

Slack

  1. Open Salesforce and navigate to the aprity app.
  2. Go to the Connectors tab.
  3. Locate the Slack card and click Generate New Code.
  4. A fresh code appears in the format APRT-XXXX-XXXX. Use it within 30 minutes.
  5. Continue with Slack — Story Agent setup from the Paste the activation code step.

Best practices to avoid expiry

  • Generate the code right before you paste it. Don't generate ahead of time and store it in a doc or chat.
  • Have the tracker side ready first. Install the Forge app / Marketplace extension / Slack app, navigate to the Aprity Configuration page, and confirm the paste field is visible -- then come back to aprity and generate the code.
  • Use a separate browser tab for Salesforce and the tracker, so you can paste with one keystroke.
  • Codes are case-insensitive but otherwise must be pasted verbatim, including the dashes.

What if I see "code expired" with a code I just generated ?

If the code visibly expires within seconds of being generated, the most likely causes are :

  • Clock drift -- your laptop or the Salesforce sandbox you are using has a significant clock skew. Restart your machine and re-sync NTP.
  • Cached panel -- you are looking at a stale Aprity Configuration page in the tracker. Hard-refresh the tracker tab (Ctrl + Shift + R or Cmd + Shift + R).
  • Disconnected aprity backend -- very rare, transient issue. Wait one minute and re-generate.

If the issue persists, contact support@aprity.ai with your aprity tenant id and the tracker you are trying to connect.

Verify after the fix

After a successful paste, the tracker panel switches to Connected to Aprity (Jira / ADO) or the Slack app reports a successful bind. From there, follow the rest of the per-tracker setup guide to start generating stories.

For anything else, contact support@aprity.ai.