What's an entitlement?
An entitlement consists of a user-to-app mapping and an all-purpose transaction note field for storing client-specific text data.
In communications between clients and Splunkbase, an entitlement record can contain:
username: the splunk.com login of the the entitlement grantee
addon_id: the primary key of the app in Splunkbase
addon_name(only on retrieval): the name of the app in Splunkbase (this is provided for convenience in reading records)
grantor_username: the splunk.com login that was used to grant the entitlement
grantor_ipaddr: the IPv4 address of the client that was used to grant the entitlement
transaction_note: a free field for clients to use to store data relevant to the entitlement (invoice #, transaction ID, etc.). Up to 1024 characters
create_time(read-only): the UNIX timestamp from when the entitlement was created
last_update_time(read-only): the UNIX timestamp from when the entitlement was last updated (or created if never updated)
To create an entitlement in Splunkbase you must provide an
username, and optionally a
Entitlements are granted on a per-app basis. Granting entitlements on specific app versions is not currently supported, but has been accounted for in the API and will be supported in the future.
When retrieved, an entitlement will always have
username, addon_id, addon_name, create_time, and
last_update_time fields. If the splunk.com account that the HTTP client uses to connect is the owner, or otherwise has editing permissions on the app (such as SB admins), the
grantor_username, grantor_ipaddr, and
transaction_note are included.
The only field in an entitlement that can be updated by a client is the
last_update_time field will update automatically). To update an entitlement, you must provide the
username of an extant entitlement , as well as a new
Finding the APP_ID
To determine the APP_ID for your app, log into Splunkbase, navigate to the app, scroll to the bottom of the listing, click Edit and locate the App Primary Key on the resultant page'. This is the value to use for APP_ID.
What is supported by this API
This documentation applies to the following versions of Splunk® Answers and Splunkbase: splunkbase