> For the complete documentation index, see [llms.txt](https://docs.indicio.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.indicio.tech/developer/indicio-proven-r/api-reference/subwallet-super-admin-role-only.md). # Subwallet super Admin role only Authenticate with base API key ## Create a new subwallet > This endpoint allows you to create a new subwallet by providing a wallet name and an optional label. ```json {"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Subwallet - super-admin role only","description":"Authenticate with base API key"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/subwallet/create":{"post":{"summary":"Create a new subwallet","description":"This endpoint allows you to create a new subwallet by providing a wallet name and an optional label.","tags":["Subwallet - super-admin role only"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["wallet_name"],"properties":{"wallet_name":{"type":"string","description":"The name of the subwallet to be created."},"label":{"type":"string","description":"An optional label for the subwallet."}}}}}},"responses":{"201":{"description":"Subwallet created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"wallet_id":{"type":"string","description":"The ID of the created subwallet."},"token":{"type":"string","description":"A token for the created subwallet."}}}}}},"400":{"description":"Subwallet creation failed due to missing wallet name.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message indicating the reason for failure."}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal server error while creating subwallet.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}} ``` ## Retrieve all subwallets > This endpoint allows you to retrieve all subwallets created under this base admin. ```json {"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Subwallet - super-admin role only","description":"Authenticate with base API key"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/subwallets":{"get":{"summary":"Retrieve all subwallets","description":"This endpoint allows you to retrieve all subwallets created under this base admin.","tags":["Subwallet - super-admin role only"],"responses":{"200":{"description":"Retrieved subwallets successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"wallet_id":{"type":"string","description":"The ID of the retrieved subwallet."},"token":{"type":"string","description":"A token for the retrieved subwallet."},"label":{"type":"string","description":"A label for the retrieved subwallet."}}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal server error while retrieving subwallets.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}} ``` ## Retrieve subwallet by wallet\_id > This endpoint allows you to retrieve a subwallet by its wallet\_id ```json {"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Subwallet - super-admin role only","description":"Authenticate with base API key"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/subwallets/{wallet_id}":{"get":{"summary":"Retrieve subwallet by wallet_id","description":"This endpoint allows you to retrieve a subwallet by its wallet_id","tags":["Subwallet - super-admin role only"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"The ID of the subwallet"}],"responses":{"200":{"description":"A subwallet record","content":{"application/json":{"schema":{"type":"object","properties":{"wallet_id":{"type":"string","description":"The ID of the retrieved subwallet."},"token":{"type":"string","description":"A token for the retrieved subwallet."},"label":{"type":"string","description":"A label for the retrieved subwallet."}}}}}},"401":{"description":"Unauthorized."},"404":{"description":"Subwallet record not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Internal server error while retrieving a subwallet.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}} ``` ## Create a new API key > Generates a new API key and stores its HMAC in the database. API key names must be unique per wallet. ```json {"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Subwallet - super-admin role only","description":"Authenticate with base API key"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/apikey/create":{"post":{"summary":"Create a new API key","description":"Generates a new API key and stores its HMAC in the database. API key names must be unique per wallet.","tags":["Subwallet - super-admin role only"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wallet_id":{"type":"string","description":"The ID of the wallet for which the API key is being created."},"name":{"type":"string","description":"A descriptive label for the API key."},"roles":{"type":"array","items":{"type":"string"},"description":"The roles associated with the API key."},"expires_at":{"type":"string","format":"date-time","nullable":true,"description":"Optional ISO-8601 timestamp when the API key expires. Omit or set to null for no expiration."}}}}}},"responses":{"200":{"description":"API key successfully created.","content":{"application/json":{"schema":{"type":"object","properties":{"api_key":{"type":"string","description":"The generated API key."},"key_id":{"type":"string","description":"The ID of the stored HMACed API key."},"name":{"type":"string","description":"The saved label for the API key."},"status":{"type":"string","description":"Status message."},"expires_at":{"type":"string","format":"date-time","nullable":true,"description":"The selected expiration timestamp, if provided."}}}}}},"400":{"description":"Bad request. Missing or invalid parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message."}}}}}},"401":{"description":"Unauthorized."},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message."}}}}}}}}}}} ``` ## Revoke an API key > This endpoint revokes an API key by deleting it for the specified wallet and name. ```json {"openapi":"3.0.0","info":{"title":"Proven API","version":"1.0.0"},"tags":[{"name":"Subwallet - super-admin role only","description":"Authenticate with base API key"}],"servers":[{"url":"https://proven-4-2-test.proven.indicio.tech"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/apikey/revoke":{"post":{"summary":"Revoke an API key","description":"This endpoint revokes an API key by deleting it for the specified wallet and name.","tags":["Subwallet - super-admin role only"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["wallet_id","name"],"properties":{"wallet_id":{"type":"string","description":"The ID of the wallet associated with the API key."},"name":{"type":"string","description":"The name of the API key to be revoked."}}}}}},"responses":{"200":{"description":"API key successfully revoked","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Status message indicating the API key was successfully revoked."}}}}}},"400":{"description":"Bad request. Missing or invalid parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message indicating what went wrong."}}}}}},"401":{"description":"Unauthorized."},"404":{"description":"API key record not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.indicio.tech/developer/indicio-proven-r/api-reference/subwallet-super-admin-role-only.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.