These docs are for v1. Click to read the latest docs for v3.

Create a new credential for an API client. Only the owner of an identity can create credentials for it. Credentials are in active status at creation, and by default expire two years from their creation date. However, credentials expire differently when the API client is based on Control Center user permissions, and follow the same rotation schedule listed for user passwords on those accounts. Run the Update a credential operation to change the expiration date, description or status. Save information from the response information like the credentialID for future use. This is the only time you see the client secret. If you don't save it at this time, you'll need to create a new credential.

Click Try It! to start a request and see the response here!