> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# API কী

> CLI থেকে প্রোগ্রামেটিক অ্যাক্সেসের জন্য API কী তৈরি, তালিকা ও প্রত্যাহার করুন

API কী CLI, পাবলিক REST API, MCP সার্ভার, n8n নোড ও ওয়েবহুক প্রমাণীকরণ করে। এই কমান্ডগুলো দিয়ে আপনি বর্তমান ওয়ার্কস্পেসের কী পরিচালনা করতে পারেন।

## settings:api-keys

আপনার ওয়ার্কস্পেসের সব API কীর তালিকা দেখুন। শুধু মেটাডেটা (id, নাম, কী প্রিফিক্স, তৈরির তারিখ) ফেরত আসে — তৈরির পর পূর্ণ সিক্রেট আর কখনো দেখানো হয় না।

```bash theme={null}
so-me settings:api-keys
```

```bash উদাহরণ theme={null}
# All keys as JSON
so-me settings:api-keys

# Compact table
so-me settings:api-keys --table

# Map each key name to its ID
so-me settings:api-keys | jq -r '.[] | "\(.id)\t\(.name)"'
```

## settings:create-api-key

একটি নতুন API কী তৈরি করুন। সফল হলে পূর্ণ কীটি একবারই প্রিন্ট হয়, এরপর শুধু মেটাডেটা (`id`, `name`, `keyPrefix`, `createdAt`) দেখানো হয় — এটি সংরক্ষিত থাকে না এবং আর ফিরে পাওয়া যায় না।

```bash theme={null}
so-me settings:create-api-key --name <name>
```

| অপশন | বিবরণ |
| - | - |
| `--name <name>` | কীর নাম **(আবশ্যক)** |

```bash উদাহরণ theme={null}
# Create a key for CI
so-me settings:create-api-key --name "ci-pipeline"

# Create a key for a teammate's local machine
so-me settings:create-api-key --name "jane-laptop"
```

```text আউটপুট theme={null}
  API key created

  Save this key — it will not be shown again:

  sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

  { "id": "...", "name": "ci-pipeline", "keyPrefix": "sk_live_xxxx", "createdAt": "..." }
```

> [!WARNING]
>
> পূর্ণ API কী তৈরির ঠিক পরে শুধু একবারই দেখানো হয়। এটি নিরাপদ কোথাও (সিক্রেট ম্যানেজার বা এনভায়রনমেন্ট ভ্যারিয়েবল) কপি করে রাখুন। হারিয়ে ফেললে কীটি প্রত্যাহার করে নতুন একটি তৈরি করুন।

## settings:revoke-api-key

ID দিয়ে একটি API কী প্রত্যাহার করুন। ডিফল্টভাবে নিশ্চিতকরণ প্রম্পট দেখানো হয়; এড়াতে `-y`/`--yes` দিন। প্রত্যাহারের পর ওই কী ব্যবহারকারী যেকোনো ক্লায়েন্ট প্রত্যাখ্যাত হবে।

```bash theme={null}
so-me settings:revoke-api-key <id> [options]
```

| আর্গুমেন্ট / অপশন | বিবরণ |
| - | - |
| `<id>` | API কী ID **(আবশ্যক)** |
| `-y, --yes` | নিশ্চিতকরণ প্রম্পট এড়িয়ে যান |

```bash উদাহরণ theme={null}
# Interactive (prompts for confirmation)
so-me settings:revoke-api-key 550e8400-e29b-41d4-a716-446655440000

# Non-interactive (for scripts)
so-me settings:revoke-api-key 550e8400-e29b-41d4-a716-446655440000 --yes

# Find a key by name, then revoke it
ID=$(so-me settings:api-keys | jq -r '.[] | select(.name=="ci-pipeline") | .id')
so-me settings:revoke-api-key "$ID" --yes
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.